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lOMENTS 




i. Tutorial 



Real 3D V3 contains many new features and improvements. This chapter presents sortu towii 
examples to demonstrate Ihese. See the reference section for more detailed descriptions 

Getting started with Real 3D v.3 

Welcome to Real 3D v.3. This first tutorial example will take you step-by step through the proi ws ol 
creating an animation. If you are unfamiliar with Real 3D. Ihe tutorials will show you hi W eas\ ii 
create animations, but no attempt will be made here lo explain the various functions you will bci lining 
in any detail. The reference serlion of the manual is the best place to look lor detailed Fum tion 
descriptions of the actions you will perform in these tutorial examples. 

So, lets create a simple animation' a moving wooden sphere. 

1, Start Real 3D by clicking the "lutorFnv' icon. 

2. First we create a sphere: 

- Select Create/Visibles/Sphere from the menu. 

- Qkk the left mouse button once on Ihe large View window with Ihe label Ii onh n u 
Move the mouse to see how Real 3D draws a spherical shape. 

-Click Ihe left mouse button again to create a sphere. 



Defining a sphere. 



(roitiView, Pnrnl, C: N: 




CHAPTtK i: TUTORIAI 



CI IT1NC MNKFin WITH rem 30 V-3 



GETTING SIAR1ED WITH REAl 3D V.3 



3, Next, we need to change the material of the sphere to wood. 

- Click on the image of the pine wood material in the material select window at the right of the screen, 

- Click the Parallel button at the bottom of Ihe same window. 

Now Real 3D will wail for you to draw a material mapping' rectangle in the view window; 

- Move the mouse to a point above and to the left of the sphere and click the left mouse button. 

- Move the mouse down and right until the rectangle drawn by Real 3D covers the sphere. 

- Click the left mouse button again to finish the rectangle. 
This will now map the wood grain pattern onto the sphere. 



Defining a material 
mapping. 



ft am View, ParaL C;N: 



4. To make sure we have created a wooden sphere: 
- Select the menu View/Render/Window. 

Real 3D renders a shaded image. 



A wooden sphere. 




5. The Select' window at the top right corner of the display shows you the hierarchical structure of the 
wooden sphere. The 'Roof objeel consists of iwo sub objects: a sphere and a wood mapping. 



The select window shows the 
hierarchy of the wooden sphere. 



Select 



root 

elliosoid 






ALL I WO WE I IWV ' 



The name of the previously created wood mapping object is highlighted. This means it's in a 'selected' 
state. We're going to animate bolh the sphere and the wood mapping together, Iherefore; 

Select the 'Root' object by clicking its name with the left mouse button on the select window. 



Selecting the Root' object 



. 



Ail |TONF| m 



6. We'll use Ihe keyframe technique to animate Ihe sphere Animation operations can be l anted oui 
Ihe key editor window. 



in 



The key editor 
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- Pick 'Keyframe' from the 'Method' list of the key editor. 

- Make sure the 'Root' object is stilt selected 

- Click the Create' button in the key editor to start keyframing. 

7. Next we will define a second keyframe, 

- Move the mouse on lop of the last frame index '49' displayed in the key editor and ( In k the left 
mouse button. 

Alhiti vertical line jumps to that frame This shows the current lime. Now we wiH create the second key 
frame 

- Click Ihe Create Key' button. 

A new, small rectangle which represents (he second key frame, appears al tin end oi the horizontal 
time line' of Ihe key editor 

- Select the function Modify/Linear/Move from the menu. 

- Click in Ihe middle of the sphere. 

Move the object lo a new position and click again. 

8. The second key frame was defined at the end of the animation. 

- Play the animation to the beginning by clicking the '« button in the key editor 

The sphere moves to ils original position. 



e 
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9. Let's make the motion more interesting by creating a Ihird keyframe. 

- Click on frame '23', 

- Create a new keyframe by clicking the 'Create Key' button. 

- Move the object to a new position with the menu function Modify/Linear/Move. 

10. The final step is to preview the animation. 

- Open the Animation window by selecting the menu File/Windows/ Animation. 

- Make sure that the Ray trace' option, not Wire frame', is selected. 

- Set the Save field to View'. 
Click the 'Preview' button. 



V3samples\ 
firsttutprj 



lliv ammation window 
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Frame and 



This renders and shows the animation automatically. 



Modelling 



Rounding 

yThe Modify/Freeform/Round function; despite its name, may be applied not only to freeform curves 
but also to polygon and polyhedron primitives Lets experiment with this; 
V3samples\ „. , 

round.pri '■ SclecI Oeate/Visibles/Polyhedron and draw an I shape. 

2. Select by shift -dragging the top left . orner points of the polyliedron 

3. Select the menu Modify/Freeform/Round. 

4. Enter 0.1 into the radius field. 

5. Enter ft into the point count Held 

6. Click OK The top left corner becomes rounded. 

7. Shift-drag all the points at the right edge of the polyhedron, 
8 Hit Hie 5' key (it's the hoi key lor repeat last action). 

" Errter a radius of 0.05. 
10 I nter 3 as the point count for rounding and ilick OK. Two corners more become rounded 
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A rounded polyhedron 
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Surface coordinates 

This example demonstrates the View/Type/Surface coordinate mode, which makes it possible to draw 
curves directly onto object surfaces. 

1. Start a new project with menu item File/Project/New 

2. Select View/Viewcam/Reset all. 

3. Select View/Input Plane/Reset Hot Point. 
Let's first create an object to project surface coordinates onto later. We'll use the lathe U .. >l 

4. Select the menu Create/Compound tools/Lathe. 

5. Draw a vertical axis in the middle of the view window. 

6. Shape a candle stick. Use the right mouse button twice when you have Finished with the lathe Un \\ 

7. Activate the View/Type/Surface option from the menu. 

8. Select Creale/Conlrols/B-spline Knot. 

It is important to define the curve with knot points instead of control points, because otherwise the 
typical B-spline rounding nature may dislocate the actual curve shape from ftc candle 5t« k SUrffli 

9. Draw a curve in a view window. 

v3samples\ Make sure every mouse button click hits the candlestick. You can also use the CUTSOl k.-\ S h I rotate 
surfcrd.prj around the candlestick while you are drawing. It is best to define curve points quKe di nserj loensure 
thai the created curve follows the surface as well as possible. 

10. Finish Ihe curve definition with a right mouse button click. 
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Freeform modelling 

In this example, we'll create a freeform object consisting of a ring and a hook which is smoothly joined 
to the side of the ring. This example isn't intended as an introduction to B-spline modelling; read the 
freeform modelling section of the main manual first 



A fn't'form objed 



1. Let's start by taking a front view: 

- Soled menu View/Viewcam/Set XY. 

- Select View/Type/Parallel, which is a suitable mode for accurate modelling. 

2. The ring shape is easy to create: 

- Select Create/Freeform/Torus. 

- Accept the default 8*8 point count for the mesh. 

- Shape a small circle and then a larger one. 

7). Now take a suitable side view: 

- Select menu View/Viewcam/Set YZ. 

Zoom in either by pressing ' t 'key several times or use the function View/Viewcam/Pos&Zoom in, unlil 
the area to which the hook will be attached is displayed in a scale which allows accurate working. 

4. We'll define a smooth blend from the ring to the hook ivith cross-sectional building. Therefore, we 
need some cross section curves. 

Select Create/Controls/B-spline Circle 

- Draw a circle in the middle of the ring 

The radius of the circle should be almost as big as the diameter of the ring ( see the picture below ). 

5. To create the second cross-section; 

- Use Modify/Structure/Duplicate to duplicate the circle. 
Select Modify/Linear/Size 2D. 

- Click in I he middle of the circle, then at its edge. 

- Make the copied circle slightly smaller. 

6. Apply the Duplicate and Size 2D functions once more. The result should be three equally centered 
circles as shown in the figure below. 
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Cwss-sections tor surface 
blending 



7 Duplicate the smallest circle, but don't resize it this time Rename the copy as tin le' to make II easily 
identifiable. 

8. Take a front view. Move all the circles to the left side of the ring. 

9. Now we will projeel the first three curves onto the surface of the ring with ihe parallel shrink wrapping 
function Let's define the parameter objects carefully: 

- Select the ring mesh from the select window. 

- Press the shift key down and select the first three circles in the order they were createi I 

- Release the shift key. 

If you did everything correctly, Ihere should now be four objects selected. 

- Then select menu Modify/Special/Parallel Shrink. 

Draw a line from the middle ol Ihe circles to the right, far enough so all the points ol the I In Ice when 
moved the amount defined by the line, would hit the ring. 

For example, you can draw the line all the way to the middle of Ihe ring. After the line has been defined 
the circles move to Ihe right and bend along Ihe surface of Ihe ring as they hil it 



t lunl ftr.w, PdiBl (to 




Shrink wrapped circles 



10. Parallel shrink actually projects the control points onto the surface, and the * urVCS may now be slightly 
inside Ihe ring. For the outermost curve, this is OK, because it guarantees Ihere ivon I be a gap 
between Ihe hook and the ring. 

- Select the two smaller projected curves 

- Apply Ihe ModiFy/Freeform/lnverl function to them. 

This converts Ihe control points to knot points and we gel a more » I urate result 
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It The actual hook will be created with orthogonal sweeping. For thai purpose, we need a new curve; 

- Select Create/Controls/B-Spline knot. 

- Draw a hook-like curve starting from the middle of the unmodified circle (see the picture below). 

- Use knot point editing (Modify/Freeform/Move Knotpoint) to fine tune the shape if necessary. 

- Rename the curve as 'hook'. 



A spline curve for the hook 



I nit* View, i-'ntil C.N: 




12. Multi-select the two curves, first 'circle' and then hook'- Select menu Create/Build Freeform/Orthogonal. 
A hook-like mesh is created. 

13. Delete the 'hook' and circle' curves. 

14. Actually, the orthogonal sweeping was used only as an intermediate step: 

- Select the hook mesh 

- Apply the (unction Modify/freeform/Surface to Curves lo it. 
A set of cross section curves is created. 

15. Delete the hook mesh. We don't need il any more. 

16. Let's analyze what kind of curves we have. First there are the three curves which were projected lo the 
ring. After that follow cross sections from the hook mesh. Since the iross sections generated by the 
Surface to Curves operation represenl the control polygon structure of the hook mesh, Ihe first cross 
section may be partly inside the ring. If this is the case, delete it. The purpose is to get a nice ordered 
sequence of cross sections. 

17 Continue as follows; 

- Select the lasl curve in the hierarchy. 

- Duplicate it twice. 

- Multi-select the last three curves, and use Modity/About COGs/Size 3D to squeeze them into a single 
point 

- Move them slightly to the front of the last unsqueezed curve. 

The last three curves will generate the closing cap for the hook mesh. 
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Cross-sections for the hook. 
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v3samples\ 

hookobj.prj 



18. All the curves should now be in the correct order in the hierarchy, so select them all by dragging ov« 
their names on Ihe select window. 

19. Use the menu Create/Freeform/Build from Curves. A hook mesh is recreated, this rime with fl smooth 
blending lo the ring and a closing cap. 

20. Delete all the curves and the objeel is ready. 




Fractals 

The project file v3samples\fractal.prj contains some predefined fractal trees lb use them 'I" UlC 
following; 

1. Select File/Projecl/lnsert sections from the menu. 

2. Press Ihe 'None' button of the opened file selector to clear all sections lhiMi.htu.it. the Fractal Frees 
gadget. Click on OK. 

3. Select the file 'examples, jfractaLpr? using Ihe file dialog. 

4. After Ihe file has been loaded, select Create/Fractals/Tree This opens the fnw la) tree dialog 

5. Click the load' button A list dialog is opened. Select one oi the predefined trees, then ilk k OK and 
define the first branch lor the tree by drawing first a sphere whii h defines the diameter ol the first 
branch and then a line, whiih defines the length and Ihe dire* lion "I the branch fhe fractal tree is then 
created. 
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6. You might also want to use a leaf object in which case create and select the object to be used as the 
leaf prior to activating this function. 

NOTE; Delete the created tree before trying to create the next one. Otherwise you could inadvertantly 
use the previously created Iree as a leaf object for the new tree, which will lead undoubtedly to a nol- 
enough-memory situation 



v3samples\ 
glow.prj 



Materials 

Glow example: a space ship 

In this example, glow feature is used to make windows of a space ship to glow and to create a 
smoothly glowing exhaust flame behind the ship. 

1. Draw two texlure maps in a paint program The first one, panels will be used as a color map to 
represent surface details of the ship, so it may consist of rectangular areas of grayish blue shades. The 
second one, 'lights', should contain suitable groups and rows of bright yellow dots (used for windows) 
against a black backround. Save the textures to Real 3D's textures' drawer. 

2. Model a simple space ship in Real 3D. For example, use Create/Compound tools/Lathe to create a 
suitable shape, The color of the ship docs not matter. Rename the created object as 'ship'. 

3. Use Create/Structure/Level to create a new level Rename ii as fire, and make il the currenl level. Create 
a bright orange sphere (Create/Visibles/Sphere) behind the ship, and use Modify/Linear/Extend to 
make it a (lame like elliptic shape. The ellipsoid will be the source of Ihe exhaust flame glow. 

4. Use File/Matcrials/Window to open the material editor. Define a new material with the following 
properties: 

- Name 'panels' 

- Texture panels' (the texture map you just created) 

- Tile X and Y on 

- Color map and Bump map on 

- Specularity 20, Specular brightness 30-40 (to get a metal-like effect) 

Press Apply to create the material. 

5. Press Reset and define another material with Ihe following properties: 

- Name 'fire' 

- Unshaded option on (the exhaust flame doesn't require shading) 

- Clow size 90, Glow brg 100 Press Apply. 

6. Press Resel and define a third material: 
Name lights' 

Texlure 'lighls' (Ihe second texture map you crealed) 
Tile X and Y on 
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- Color map on 

- Unshaded option on, to make the windows behave as if they are lights inside the spaceship 
Transp. Color option on, and the Transp color should be black R=0, C=0. B=0 

- Exclusive and Scope mask on; Scope mask is important, otherwise the whole ship will glow. 

- Glow size 80. Glow brg. 50 

Hit Apply lo create lights' material. Close the material editor. 

7. Use Create/Mapping/Default, select 'fire' and click OK to create a mapping inside Hie 'fire hierarchy 
level (see the hierarchy diagram below). 

8. Make 'ship' the current level. Select a view so that Ihe ship is 'end on'. Then creale/Mapping/Cylindrr 
twice and shape two cylinder maps around the ship; the first one should refer lo panels and tin- 
second one to lights'. Now Ihe ship hierarchy should be as follows: 



root 



ship 
parti 
part2 



panelsfT) 
lightsfj) 



fire 



ellipsoid 
fire(T) 



9.Take a suitable view to the ship scene. Then open render settings. Select Environment ui I amplcss 
mode (you can also use Shadowless or Normal mode if you've added some light sources) vt 
background color lo black. 

10. Press POST EFFECTS button. This opens the post effect editor. Select 'Glow' from the ftwl off© I Usl Bl 
the left. Then press 'CREATE' button, so that a new effect called Glow is inserted to the fifftt I lis! Press 
EXIT to close Ihe dialog. Then press OK to exit the render settings dialog 

1 1, Render Ihe scene. 

Using similar techniques to those described above allow you lo add glows in either an entire object or 
just sections or it. 

One way mirror 

Here is an interesting use for the new angle scope handler. 

oneway pri JUSt '° ad th ° 0NEWAYPR - 1 antJ rt -' nde r to see a transparent ro tangle, then use the mouse in Ihe view 
'" ' window (Viewcam Pos.) lo swing around lo the other side. Render and Ihe rei tangle is a mirror. 

This opens up some interesting possibilities for animations oi Ml ky lighting effects. 
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The effect is created like this; 

1. Create a rectangle in parallel XY view 

2. Create the following materials with only these settings: 



mirror 




transp 
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( specularity J 
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1 specbright I 
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3. In XY parallel view, parallel map 'mirror' onto the rectangle. 

4. Rotate horizontally using the arrow keys so you are looking at the reclagle from behind. 

5. Parallel map transp' onto the rectangle. 

6. Select render settings LAMPLL5S, SHADOWLESS or NORMA! 

7 Set the background and environment colours to the same values. 
8. Render 

Animation 

Path animations 

Path animations contain one major improvement, now the user can control over how the lime is 
distributed along the path curve, This is done through the key editor window (Animate/Edit). 

V3samples\Palh1.prj' example contains a simple move along a path' animation with a nonuniform 
knot-time distribution. To recreate a similar animation 



\ >samples\ 

path l.prj I. Create a sphere. 



2. Select Animate/Edit to open the key editor 

3. Set the 'Method' selector in Ihe key editoi to Motion Path', make sure that the sphere is selected and 
click the 'Create' button. This opens the same window as Ihe (unction Animate/Create/Path, Select a 
Polygonal' path and draw the curve on a view window. 
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v3samples\ 
path l.prj 



Use select window to make the created path method the current level. The lime line of the path 
method displays as many knots as Ihe defined path has points. 

Play the animation to the end using the '»' button of the key editor. 

Pick some knots on the lime line and move them to new frame numbers For example, il you would 
like the object to reach the third point of the path at frame 20, just move the third knol to Ihe frame 20 
Then play Ihe animation back to Ihe beginning using the '«' button. Note how the sphere reai hes 
each point of the line at given knot times. 
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v3samples\ 
path2.prj 



The animation methods recognize one new attribute 'Inherit . This defines whcthei I n in it the hm< 
transformations applied by the method in question are inherited to successive methods 

The example V3samples\Path2.prj' demonstrates how two path methods can I"' used Wl the same 
hierarchy level. The 'Inherit' attribute of the firsl method is not set. so il is possible to urn. lily the time 
line of the first method without affecting the behavior of the second one 
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A simple keyframe animation 

This example contains a simple keyframe animation. The animation consists of four keyframes. In Ihe 
firsl frame Ihe object is on Ihe top left edge of the view window. In the second frame Ihe object is in 
the middle of the window. In the third frame the object is rotated 90 degrees. In the last frame Ihe 
object is moved to the bottom-righl edge of the window and has doubled in size. 

To create a key frame animation: 

1. Select File\Project\New to clear all objects from the scene. 

2. Create a rectangle to the top left edge of a view window. 

3. Open the key editor window by selecting the menu Animate/Edit 

4. Set the 'Method' selector to 'Keyframe'. Make sure that the rectangle is selected and click the "Create 
button. This initializes a keyframe animation. 

5. Press the Edit' button of the key edilor. The select window will refresh and display the contents of the 
newly created keyframe method. You can see a copy of the rectangle and a loordsys in the select 
window. The copy of the rectangle stores the original state of the target and Ihe coordsys represents 
the first key frame. 

6. Click on the last frame number displayed on the key editor window. Time is changed to that frame. 

7. Click the 'Create Key 1 button. This creates a new key frame. Now select Modify/Linear/Move and move 
the rectangle to Ihe right botton corner of the view window. Then rotate Ihe object and change its size 

Note: the correct items are automatically selected by the key editor so don'l select objects yourself 
while working with the key edilor window unless you fully understand the way the keyframing system 
works. 

8. Go to a new position in time by clicking Ihe desired frame, click Create Key, modify and so on until all 
keyframes are defined. 



Jl_ 



Creating hierarhical animations using keyframing 

v.»samplcs\ j ne j, as|C t( j ea Q f hierarchical animation is simple. For example, a bouncing ball can be constructed 
Kcvl — P r J hierarchically so that Ihe 'up-down' motion is defined first, and another motion moves Ihe entire 

system forwards 

Also the keyframe animation method can be applied to all objects including those already animated by 
using any of the available animation lechiques. A good example is an arm of a robot: the keyframe 
method can first be applied to the forearm. Por example, the forearm can be rotated about the elbow. 
Then keyframing can be applied again to Ihe complete arm in order to rotate it about Ihe shoulder. 

Lets create a simple bouncing ball animation First In addition to hierarhical animation issue, this also 
demonstrates how to create closed loop motions, 

I & lee I Ihe function Create/ Visibles/Sphere and define a sphere near the top left edge of Ihe view 
window. 



2. Open the animation window and set Frames' to 40. Close the window. 

3. Make sure that Ihe sphere is selected (if not, select it using Ihe select window), select Keyframe from 
the melhod list of the key editor window and click the Create button. This initialises a keyframe 
animation which consists of one keyframe. 

4. Click Ihe 'Edit' button. This prepares Ihe key edilor for editing the created keyframe method, and the 
select window is updated to show the hierarchy inside the keyframe method. 

5. To keep this example short, let's create only two keyframes for the up-down motion So, move to 
frame 20 by clicking on that number in Ihe frame list at the top of the key editor, click on the ( rate 
Key' button and finally move sphere downwards so that it is near Ihe bottom edge of Ihe \ lew window 

6. Set the Closed' checkbox of Ihe key editor to get a closed motion, this means tin- sphere will return 
back to its initial position between frames 20 ... 39. 

7. Use » and « buttons to play Ihe animation and to make sure it works as expec ted 

8. Let's get acquainted with the envelope window. Click the Envelope' button to open the envelope editor 
Set Envelope to Translate and check the X, Y and 2 check boxes. You will see three curves which fthovt 
you how the sphere moves in all three coordinate directions as a function ol time. Note thai the* 
curves are measured in the object's own local coordinate space, not in the absolute spa* e 




The envelope window shows how Ihe object moves. If you are not satisfied with the mi >in ins there are 
two ways of editing (he animation: by modifying the key objects, or by modiFing the envelope i urves 
directly. Let's try both approaches. Leave the envelope window open so you can see how tin- envelope 
curves change when you move the key objects. 

9. So, lets modify the second key frame object Jump to the second key frame objCi I l»\ - to king the 'Next 
Key 1 or Prev Key' button {depending on what frame you are currently on) rhc keyframer automatically 
selects Ihe correct objects; therefore you can apply modify functions without having to worry about 
object selection. So, select the function Modify/Linear/Move and move Ihe sphere to a new location, 
The the curves in the envelope window will be moved accordingly. 

10. Then modify any of the curves through the envelope window by i In king on oneol Ihe small 

rectangles denoting the knots of the curve and by moving il If you wanl to see what impact this has fa 
the sphere, click the Update' button. You can also multi-select several knots by dragging a box around 
Ihe knots. 
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11. As a final step, we will apply keyframing again to Ihe bouncing sphere object Using ihe select window 
find the level object containing the original ellipsoid and the keyframe method. Select it and click the 
key editor's Create button to define a new keyframe method. Go to the last frame by clicking on it in 
the editor's frame scale. Click the Create Key button and move the bouncing sphere to the right edge of 
the view window. Play the animation and the bouncing sphere moves sideways while it bounces up 
and down. 



Pivot points 



u 



As long as you only move objects in key Frame animations, you don't have to worry about pivot 
points. As soon as rotation or scaling is applied, pivot points start to play an important role 



v3samples\ jfe reason for this is that keyframer rotates and scales objects relative to the pivot point For example, 
keyR.prj j n a fj n g er pivot points should be located to the joints of Ihe finger, because otherwise keyframe 

interpolation might pull joints apart from each other 

So, let's create a simple animated arm to demonstrate usage of pivot points- I, First create a forearm 
For the sake of simplicity, we'll use a rectangle to represent the forearm. Select Create/Visibles/ 
Rectangle and define a suitably shaped rectangle. 

2 Open the key editor with Animate/Edit 

5, Create a keyframe animation by setting the key editor's method selector to 'Keyframe" and clicking on 
the Create button This initializes the animation with one keyframe. 

4. Move to the last frame and click the Create Key button This creates the second key frame. 

Now its time to think of what kind of motion we would like the forearm to take. Let's rotate it around 
its elbow. At this point, pivots become important. Because we want the forearm to rotate around the 
elbow, the pivot point must be positioned at the elbow. 

5. To redefine the position for the pivot point, just click the 'Pivot' button and set the new position by 
clicking in the View window where the pivot should be, in this case at the elbow. 

6. Activate the Modify/Linear/Rotate function and rotate the forearm, say, 90 degrees about its elbow 

Note: the pivot point is actually the COG for the object so using Modify/About COGs/Rotate, Scale, etc 
would ensure any modifications are centered on the pivot point 



The rectangle is rotated 
90 degrees about its 
elbow in the second key 
frame. The pivot point 
h marked mth + ' sign. 
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7 Now play the animation back to the beginning (click the « button). The forearm rotates towards its 
initial position and the elbow is fixed to the pivot point. 

8. Now the forearm is completely animated and it is time to create the upper arm. Make Rool object the 
current level and create another rectangle representing Ihe upper arm. Ihe hierarhiuil strut ture of Ihe 
animation should look as follows; 

Root 
level 

forearm 
KEYFRAME 

upperarm 

9. Animating the upper arm doesn't differ from animating the forearm. This time we don I want to notato 
Ihe upperarm only, but the complete arm. So. select the 'Root' object and dick key edftoi s'Cn it* 
button Then move to the last frame and click 'Create Key'. 

10. Click the Pivot button and click on the shoulder, because we want the whole arm to be rotated (A IrW 
shoulder 

11. Select Modify/Linear/Rotate and rotate about the shoulder. 

12. Play the animation 

Animated fade-out 

In this example we will see how to make an object fade during an animation 



v3samples\ *■ Create an object. For example, a simple primitive such as a ellipsoid. For this example renamu ft as 
fade.prj 'fadcobj'. 

2. Use Modify/Properties/Fade function to define the initial lade level for the fadeobj. the fad* value cdfl 
be left at zero. It is necessary to open the window even though the defaull settings has bwn used as 

this gives the object an I FAD TAG. Unless this TAG is present the program won'l be able i nplete 

the animation correclly. 

3. Select Create/Structure/Method Select MORPHING from the method Nsl and dick I 'K 
1 Make the morphing method the current level 

5. Use Create/C ontrols/Atlribute to create two attribute objects. These are Simples! pi issible objei is and 
will be used just to hold fade attribute values in a morph. 

The hierarchy is now: 

fadeobj 
MORPHINC(MORPHING) 

attribute 

attribute I 

6, Select the first attribute, then the menu Modify/Properties/Fade and set fodeMX Click on OK. 
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v3samples\ 
skelfidc.prj 



7. Select the second attribute, select Modify/Properties/Fade and set fade=255 (maximum). Click on OK. 

8. Select Animate/Edit This opens the method editor. The editor displays the morphable object 
properties This time we are going to morph only the IFAD lag which defines the fade attribute, so 
make sure Color, Materials, Geometry are not selected and that Tags button is. 

Now the hierarchy is ready. If you render the animation, you will note thai fadeobj fades out 
completely by the end of the animation. You may easily change the time interval during which the fade 
happens by setting the start and end time of the MORPMINC method using Modify/Properties/ 
Animation or by using the time line editor. 

Skeletons 

Real 3D V3 skeletons contain many new improvements which makes them an extremely powerful and 
easy to use tool for many different kinds of jobs. So, let's take a look at how the new skeleton system 
of Real 3D works 

I efs create a freeform leg and attach a skeleton to it. A good leg can be found in the objects directory 
as leg.obj', so load it in by using the function File/Objects/Insert. 



A BSpliiw hy. 




The first step is to create a skeleton and attach it to the leg. This can be done by using the function 
Animate/Create/Skeleton. Select it from the menu. 

Before you start drawing the skeleton, let's consider another new feature introduced by V3 called 
constraints'. Constraints consist of four angles associated with each joint of a skeleton. These angles 
define the minimum and maximum limits for the bones. 

These constraints can be defined interactively while you are drawing the skeleton. So, let's try this now 
by creating a skeleton consisting of three bones: the first bone is short and represents the lower part 
of the spine The two remaining bones represent the thigh and shin bones. 

Make sure that the leg is selected, then click the first point near the sacrum and the second point over 
Ihe hip bone. Now move the mouse towards the knee but don't ti\ the position for the knee yet. We 
will have to define proper constraints for the thigh bone first. So move the mouse forwards' so that it 
represents the knee in its uppermost position. Then move the mouse in the opposite direction so that 
it shows the position ol the knee in its farthest back position. Then move the mouse back over the 
knee of the leg and fix the third point by clicking the mouse. 




Define constraints by showing the frontmost and farthest back positions tor the thigh bottC 

Then move the mouse towards the ankle and repeat Ihe steps above in order to define constraints fw 
the shin bone as well. Then click the right mouse button, which terminates the skeleton ( re.ition 



A B-Sptine kg and a skeleton. 




To make sure the skeleton is properly positioned inside the leg take a look at il from different 
directions. If the skeleton doesn't match the leg properly you can freely modify the skeleton al this 
point Just find the skeleton pnmilive from the hierarchy and apply a suitable modifii ate in to il 

Now hit Ihe 'u* key (or select the menu Animate/Control/Refresh). This allai lies Ihe skeleton lo tin 
so that when you later modify the skeleton, the leg will also be modified accordingly 

So, let's modify the skeleton primitive. When you created the skeleton by using the Imu lion Animate, 
Create/Skeleton, the proper object hierarchy was automatically set up Tor you Ihe skeleton primitive 
can be found under the SIMPLE SKELETON' level. So, select the skeleton primitive ai tivate the 
function Modify/Special/lnverse Kinematic and move the ankle lo a new position b) fffSl I In king near 
the ankle and then clicking at its new position Hit Ihe 'u key and Ihe leg is bent ,i< < ordingly. 

If you modify the skeleton to its limits, you can see that the leg may not look thai good any longer 
because the skin near the joints doesn't behave as a real skin in the real world 

This problem can be solved by editing the so called fidelity attribute ol the hones So, select the 
skeleton primitive and activate the function Modify/Properties 'Skeli -ton \llis Go through all Ihe joints 
and set fidelity to 40 %. Click Ok and refresh the animation system by hitting the 'u' key. The leg starts 
to look much belter, 
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v3samples\ 
pointfid.prj 



Fidelity 

Because of the importance of Ihe subject, lei's go through another example demonstrating the use of 
the fidelity attribute. Gel rid of the leg example by selecting the function File/Project/New. 

In this example, we will create a rectangular polygonal mesh and attach a skeleton to it. When the 
skeleton is bent, it is very easy to observe what actually happens to the mesh and how the fidelity 
changes its behavior. 

So, let's create a long and narrow horizontal mesh as shown in the figure below. Select the function 
Create/Build Freeform/Mesh and define the resolution as 18 by 8 points. To make Ihe created mesh 
polygonal, selecl the function Modify/Freeform/Type and set the type to Polygon 

Then select the function Animate/Create/Skeleton and draw a skeleton consisting of four points, as 
shown in Ihe image below. 



A polygonal mesh 
controlled by a skeleton. 




Hit Ihe u' key which causes Ihe skeleton lo he attached to Ihe mesh. 

Now find and select Ihe skeleton primitive lean be iound inside the SIMPLE SKELETON' level). Then 
bend it by applying Modify/Special/Inverse Kinematic lo its last point. Hit u' to see how the mesh is 
modified 



Points near ihe joints 
cause problems 




Although we already know a way to solve problems related to points near the joints, let's do it once 
again so that we can analyze vvhal actually happens to the mesh when Ihe fidelity is changed. So, 
make sure the skeleton primitive is selected and activate the (unction Modify/Properties/Skeleton Attrs. 
Set the fidelity for all joints lo 50 % and click Ok. Hit the u key and you should see something like the 
following figure. 
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When fidelity is set to %. position for each point is determined only by one bone ol the skeleton i.e. 
all points attached to a certain bone are treated equally. The higher the fidelity Ihe more the p isJtH m ol 
the point in question is also influenced by the next and the previous bone 

The 'fidelity' scroll bar in Modify/Properties/Skeleton Attrs. dialog allows you lo define lid. lily 
separately at each joint. But what if one needs more accurate control over fidelity: 1 Say one would like 
to define higher fidelity only lor one point 

Real 3D also supports pointwise fidelity i.e. the fidelity attribute associated with eat h hour > an be 
overriden by a value associated with a target object. If the target object is a freeform mesh a line or a 
triset, the fidelity attribute is actually associated with all points comprising the largel objei I 

The check box Fidelity from targets' determines whether the fidelity is fetched from Ihe target objei b 
or from the skeleton. 

Let's try this. Make sure the skeleton primitive is selected and activate Ihe function Modify Properties 
Skeleton Attrs. Check Ihe Fidelity from targets' check box and click Ok 

Refresh theanimalion system by hitting Ihe 'u' key This causes all the fidelity lo be lost Hi. reason lor 
this is that we switched the fidelity from target' option on and the default target fidelity Is l 

So, let's change the fidelity for all those points that are near the joints. Now, select the mesh And hold 
down Ihe shift key while dragging points from ft. When all the desired points I iavi been (elected 
activate the lunction Modify/Freeform/Fidelity and enter the value 50 °/o. 

Refresh the animation system by hitting the 'u' key and the fidelity effei I is back 

Hierarchical skeletons 

v , ~ . . 1" th» example, we will go through the idea behind hierarchical skeletons i.e what they are and how 
1 they work in practise. 

A hierarchical skeleton is a skeleton which contains one or more child skeleton- \ ■■,>. ■<! > vimpleofa 
hierarchical skeleton system is an arm and five sub skeletons, fingers. 

Another example is a spine and its two sub skeletons, legs. 

So, let's try this in practise by creating a simple body. We have created a suitable body (list for this 
example. The body can be found in the objects directory as body obj So load H In by using the 
function File/Objects/Insert. 

So, a 'bod/ object was loaded. Make the body the current working level by double I Inking its name 
On a select window, and then multiselect both the meshes. 



skelbody.prj 
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Then select the menu Animate/Create/Skeleton and draw a three point yyskeleton representing the 
spine as shown in the figure below. 

Note that we have to multiseled both the meshes. The reason for this is that then and only then the 
skeleton system treats the points of the freeform objects as individual objects. If you applied the 
Skeleton' function to the level containing the meshes, it would have been treated as a solid single 
object and the skeleton would have never been able to bend it. 



Now it is time to create skeletons for the legs. So find the SIMPLE SKLI I TON method. II should 
t ontain one skeleton primitive i.e. the spine we just created. Select it and rename il as spine 

Now, make the spine skeleton the current level by double clicking its name on a select window. In 
other words, sub skeletons are created inside the parent skeleton level just like meshes representing 
the body were created inside a level object named body'. 

Then create two skeleton primitives by using the function Create/Conlrols/Skeleton. Both the skeletons 
should start from the second point of the spine and correspond the legs of Ihe body. Use dragging to 
get an exact match and notice how constraints are defined relatively to the bones of the spine. Rename 
Ihe skeletons as leltleg' and righlleg' to reflect their purpose. 



A spine and two sub skeletons te legs. 
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Now our hierarchical skeleton system is ready. Make sure that the skeleton matches properly the b- 
spliue body by observering it from other directions. If so. refresh the animation system by hitting the 
u key. 

The skeleton is now attached to Ihe body and we can try to modify Ihe skeleton and see how the body 
behaves. 

Note that in order to treat the hierarchical skeleton system as a whole, the parent skeleton must he 
selected. So, select the skeleton representing the spine and activate the function Modify Special/Inverse 
Kinematic Click near the ankle and move the mouse slowly down. When Ihe leg gets ils lull jtrcti h it 
starts to pull down Ihe spine and the other leg. 

When done with inverse kinematics, hit the key 'u' and the body is modified accordingly 

Morphing skeletons 



Now thai we have created a skeletonally controlled body, let's animate it by using morphine It -..mi 

v3samples\ have already deleted Ihe body we created in the last example, it can be found as \ Samples 
skelmorp.pr, ske | bodyprj( so jusl , oad it in 

At this point, lets lake a look at the hierarchical structure of the created objet t 

body 
level 
mesh I 
mesh2 

SIMPLE_SKELETON 
spine 

leltleg 
rightleg 

Find the 'SIMPLE SKELETON' object and make il the current level. 

Select Ihe 'spine' skeleton and duplicate it by using the (unction Modify/Strut lure I >ii|>hi ale 

Now modify the duplicated skeleton by using the function Modtfy/Special/lnverse KinenuUf 

Create a third key object by duplicating the modified skeleton and again us, imrrsr kni. nuitil s to 
modify the last duplicated skeleton. 



Three key skeletons 





Selecl all the skeletons inside SIMPLE SKELETON method and .» hv.itr Ihe Function Animate/Create/ 
Morphing. 
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vSsamples/ 

rollcube.prj 



The object hierarchy should now look as follows: 

body 
level 

meshl 
mesh2 

SIMPL£_SKELETON 
spine 
leftleg 
rightleg 
MORPHING 
spinel 
leflleg 
rightleg 
spine2 
leftleg 
rightleg 
spine5 
leftleg 
rightleg 

Play the animation and, as you can see, the skeleton is bending through the key skeletons you created, 
and the actual body is bending with it 

Surface method 

The following examples demonstrate the new powerful surface' method. This method makes rotating 
walking etc. objects automatically travel along surfaces. 

The hierarchy syntax of a surface method looks like the following: 

Root 
target 

SURFACE(SURFACE) 
gravity 
surface 
links 

linkl 
Iink2 
>« 

This perhaps looks complicated, but is not that difficult to use I et 5 make a cube roll along a table. 

1. Start a new project and create a new level called 'rotator'. Make it the current level. 

2, Take a front view fView/Viewcam/Set XY). Create a cube. 



3. Select Create, Controls/Offset, Drag a box around ttie top left t orner to create an offset exactly at that 
corner. Duplicate the created offset and move it to the top right corner. Create two more copies and 
place them to the remaining two corners of the cube. 

4. Multi-select the tour offsets and selecl Create/Structure/Link; tour links are created W<- will need Item 
later in another part of Ihe hierarchy, so select Modify/Struiture/Cut to i ut Ihem In the i lip buffci 

5. Make root Ihe currenl level. Select Creale/Struclure/Method and pick 'SURFACE' From the method M 
Then click OK. 

6. Make the created surface method the currenl level. As we see in the hierarchy diagram ah w< the firsl 

parameter defines the direction of Ihe gravity. Select Ihe menu Create/Controls/ Axis and draw a ver I 

line pointing downwards. The length and position of it does not matter, onluy Ihe dire* lion 

7 Next we create the surface on which Ihe cube travels. Take a top view, sefet 1 ( reate VisiMw/Rei tan I 
and draw a rectangle. Select Modify/ Properties, Attributes, check Infinite and diek OK Now the i ube 
can safely continue rotating forever. 

8. Take a front view and move the rectangle below the cube if it is not there yet 

9. Create a new level using Create/St ructu re/Level. Make it the current level. 

10. Select Modify/Structure/'Paste. The links which you cut in the step 4 above are pasted l».u |i 1. 1 the 
hierarchy. 

1 1. Now the surface method is finished. There is one more thing to do: the cube ilsell is still slatli Co to 
the root level, select Animate/Create/ Rotation, select Ihe Normal' and 'Periodii Options and click ( >K 
Draw the rotation coordsys in the middle of the cube. 

12. Find the rotation method from the hierarchy (it is inside the level 'rotator') arid setei I It I'm k the menu 
Modify/Properties/Animation, check Frequency and enter a value of 5. Clu k OK 

13. Play Ihe animation. The cube makes 5 revolutions and travels quite far away. 
Other examples of this subject are: 

v3samples\surfacel.pn A walking robot was created by using the sweep method rhe lurfa i method 
causes the walking robot actually move because of the friction between the Moor and the i < i i il the 
robot The friction points are placed inlo the feet of the robot 

v3samples\surface2.prj Another surface method example. A walking robol goes Upstairs NOl I 
Before playing this animation, set FileAVindows/Animation/Frann s to al least 121 1 

v3samples\surface3.prj This is another 'place walking robot on the flooi i namptc I lowevcr, one extra 
sweep method rotates Ihe rohol causing the robot to wander to different dire* lions as II he couldn't 
make up his mind about the direction 

- v3samples\surface4.prj This one is quite crazy; a rotating thing on a fit *>l 

V3samples surface5.prj In this example, a walking rohol was |.U ed on a Hon planar B-Splme surface. 
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Shrink wrapping 

This example demonstrates the 'shrink wrapping animation method. A sphere moves under a mesh 

deforming it. 

1. We start the example by creating a sphere (Create/Visibles/Sphcrei. 

2. Take a lop view. Select the sphere and the menu Animate/Create/Path. Select for example the B-Spline. 
Closed. Periodic and Auto phase options. Click OK, and draw a path tor the sphere on a view window 

3. Selett Create/Build Freeform/Mesh. When the program asks the point count of the mesh, enter 20 * 20 
points and click OK. Then shape a rectangular mesh covering most of the sphere and its path. 

4. Take a front view and lift |Modify/Linear/Move) the mesh above the sphere. 

5. Multi-select the animated ellipsoid and the mesh, and then pick Animate/ Create/Shrink wrapping 
from the menu. A dialog is opened; select 'Parallel' and Cumulative' options. Click OK. Now the 
program waits you to draw a line on a view window. The line will define the amount and direction of 
shrinking. Click in the middle of the mesh and draw a line downwards to the level of the middle point 
of the sphere. 

6. Make sure that either undo is on or save the project at this point Then play the animation. Animated, 
cumulative shrink wrapping cannot be played backwards to the original state, the shape changes are 
permanent. 



v3samples\ 
shrinkl.prj 



JJL 

v3samptes\ 
shrink2.prj 



Animated shrink 
tvruppincj 




7. Use undo to restore the animation after the playback or reload it from disk. Let's experiment with 
non-cumulative shrink wrapping too. Select the SHRINK WRAPPING method object from the 
hierarchy. Then select Animate/Edit and switch the cumulative option off Replay the animation. 

When using shrink wrapping, it is important to ensure that the density of the mesh to be shrunk 
corresponds the level of detail of the target object. Otherwise small objects may get through the mesh. 
A good trick is to surround the target object (a sphere in the example above) with another, bigger one, 
and make it RT-invisible so that it does not affect rendered images. 
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File/ 
Objects/Load 



The function Filc/Objects/Load can also load 3D Studio files. The imported dala is represented M ium-i 
primitives Triset shading can bo controlled with the Modify/Freeform/Type function. 



Project/Insert Sections, Save Sections, Replace Sections 



The sections dialog contains three new checkboxes 'Landscapes', Trees' and Rendering settings 
These controls can be used for saving and loading fractal and render settings libraries. 



Materials/Window 



Edge X/Y 

Edge X and Y buttons give additional control of the texture gradient feature. Normally the Grade X/Y 
function interpolates the texture map color to the object color at Ihe edges of the texture map If Edge 
X is set. the gradient is computed inside the texture map, but the vertical edge appears sharp. Edge Y 
does the same to the lop and bottom edges of the texture 

Freq X and Y 

In previous versions of Real 3D. setting a non-zero Frequency value for a texture map made Ihe texture 
appear the given amount of times inside the mapping, i.e. it made the texture map denser This denser 
tiling was always finite. 

Now you can enter a negative frequency value, which works in a similar way, to define the amount of 
repetitions inside the mapping geometry by taking the absolute value of the fields, but infinite tiling is 
used in (his case. This has one immediate advantage: if, for example, a spherical mapping is used with 
a negative, non-default frequency, and either bump mapping or texture gradient is also used, then the 
'scam' where the mapping reaches the full 360 degrees disappears, because the tiled texture sequence 
is repeated again over Ihe seam. 
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Texture antialiasing 

The texture antialiasing feature improves rendering quality, for example, when rendering infinite. 
i hequered planes so the texture gets dense al the horizon where bad aliasing problems could arise. 

Glow 

The material editor now contains two new material properties: glow si/e and glow brightness. As the 
name indicates, these properties may be used to simulate glowing materials like fire, laser beams and 
coronas. 

Clow size controls Ihe width oi the glowing area around the edge of the material. Glow brightness 
defines Ihe intensity of the glow. 

Glows are computed as a post processing effect Therefore, in order to activate glow processing you 
must use the Post effect editor of Ihe Render Settings dialog lo insert a Glow' effecl to the post effect 
list For further details, see the chapter Tost effects'. 

The RPL variables to control glow are gs' for glow size and 'gb' for glow brightness. Their values can 
be between and 100. The variables can be set in Scope handler formulas and RPL procedures. 

Depth scope handler 

The Depth scope handler limits the material scope in the '/. (depth) direction to the interval specified 
by the 'a' and 'b' scope handler parameters For example, if a=0 and b=0.1, a parallel mapping maps Ihe 
material 0.1 abs. space meters deep into the target objects from the mapping rectangle level in Ihe 
direction specified by the small peak. This handler may be used for example to map a texture onlo one 
side of a cube only. 

Angle scope handler 

Another new scope handler is Angle' It defines the scope of Ihe material as a function of the viewing 
angle lo the surface. The angle is described with a value between -1 and 1. The values I and 1 
correspond to directions perpendicular to the viewed surface, and corresponds to viewing along the 
surface 

The parameters 'a' and b' specify the range, inside which Ihe scope is unchanged. Outside Ihe interval, 
scope is sel to zero. Typically, this handler can be used to create 'one-sided' textures. For example, a 
texture map on a rectangle can be set to paint only one side of the rectangle by selecting the Angle 
handler with a=0, b=1.I (Ihe extra 0.1 is to eliminate accuracy problems). If a is set to -1.1, and b is set 
to 0, then the opposite side will become textured. 

Roughness bump handler 

The roughness material property has also been removed. Instead, there is now a more flexible bump 
handler called 'Roughness available. 

The parameter a' defines Ihe density of bumps on the surface. The smaller the value, the less bumps 
you get, and small values like 0.1 produce small amount of isolated bumps If a' is left al zero, Real 3D 
uses a default value 1.0 automatically. This value creates a random bump on every position on the 
surface. 

The parameter b' defines the height of the bumps. The default value, used when b' is left at zero, is 1.0. 

Note, because of the removal of Ihe original roughness parameter, the RPL variable 'ro' is no longer 
available. 



Dither color handler 

The Dither material property slider has been removed. II has been replaced by a more versatile color 
handler called 'Dither*. 

The 'a' parameter defines the density of random color spots on Ihe surface Thesmaller thi value, Ihe 
less spots you get, and small values like 0.1 produce quite isolated spots. If a is lefl al ZGTO Real 5D 
uses a default value of 1.0 automatically. This value creates a random spot on every position on the 
surface. 

The b' parameter defines the intensity of the spots. The color of a spot is obtained by modifying (lie 
brightness of the original color randomly. The default value, which is used when b is lefl al zero r I 

Note: because of the removal of the original Dither property, the RPL variable di is nolongei available 
Material color 

A new color handler called Col.repl' is included This handler uses values entered Into the mil- rials 
window transparent RGB fields to specify the color of a material. In other words, Ihecotol replace* <>n 
other color definition like object's color or color from a texture map. 

For example, you may create a specular, reflective material called gold'. If you apply it onto a fed 
object, the result is something shiny but red. If you use FromTran handler and define Transparenl Ki .1' 
to be yellow, the material makes the target objects yellow, which looks more like gold. 

Relative texture coordinates 

Relative bitmap-size independent texture coordinates have been implemented. They . an be m CCS! 
from RPL and formula handlers with variables 'relx', 'rely' and 'relz'. 

Relative coordinates have the following ranges: 

Parallel mapping: 

The Horizontal mapping edge corresponds to an interval of [0,1 1 in relx The Vertical mapping edge 
corresponds to an interval of |0.1| in rely. Mapping plane normal whose length is Ihe average ol 
mapping edges corresponds to an interval of 10,1] in relz. 

Cylinder mapping: 

Circumference of the mapping cylinder corresponds to an interval of |0,2'PI| in relx. Axis corresponds 
to an interval of 10.1 ] in rely. Radial distance from axis to circumference corresponds to an interval ol 
10,11 in relz. 

Sphere mapping: 

Circumference of the mapping sphere corresponds to an interval of |0,2'PI) in relx The arc between the 
poles corresponds to an interval of I0,PI] in rely. Radial distance from center to drcumfererw e 
corresponds to an interval of 10, 1 1 in relz. 

Disk mapping: 

Circumference of the mapping disk corresponds to an interval of |0,2"PI| in relx Radial distance from 
the center to the circumference corresponds to an interval of |0,l| in rely. The mapping plane normal 
whose length is the radius of the disk corresponds to an interval of JO. 1 1 in relz. 

Default mapping: 

relx, rely, and relz are the absolute space coordinates. 
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Fill/ 



Spline mapping: 

relx and rely are the 'natural' surface parameters: the edges of the mesh correspond lo an interval ol 

10.1 ] in relx and rely, relz is always zero. 

New image formats 

It is now possible to use PPM and JPEG images as texture maps. 

Materials/Purge 

This function scans the object hierarchy tor SMAT tags (material references) and any materials not 
appearing after the scan are deleted This means that any defined materials which are not currently in 
use by the project are removed. This is a convenient way to clean up a large project which has too 
many accumulated, and possibly duplicate extraneous materials. 

Windows/ViewTool 



Cancel 






Crrate 



Modify 




Po a Hi on 



Buttons. 



This window can be opened by selecting File/Windows/ViewTool from 
the menu. 

The window consists of a number of buttons which can be used to 
control creation and modification tools, such as 'Create/Visibles/Cube' 

The main purpose of this window is to allow faster access to the 
functions and provide greater functionality in the editing environment 



Create 



Displays the next buffered action if it is the creation of a primitive found in the Croate/Visibles menu. 
Clicking on this button opens a floating menu which duplicates the Create/Visibles menu. 

Note: Implemented in Windows version only- 



Modi fy 



Pone 



Displays the next buffered action if it is a modification as found in the Modify/Linear menu. Clicking 
on this button opens a floating menu which duplicates the Modify/Linear menu. 

Note: Implemented in Windows version only. 

Completes Ihe current phase of the creation process. For example, when creating a polymid, press this 
button, click on this button when all the points of the base polygon have been defined. 



Cancels the current creation/modification operation. 



Undo 



Removes the last point. 

Open/Close 

When creating a line or b-spline curve, this button toggles the curve between open and I l> w < I 

Angle 

During the execution of Modify/Linear/Rotate, this button can be used lo enter Ihe angle fin degrees] 
of rotation. The button only becomes active after Ihe rotational axis has been defined When < reating 
sector primitives, the open angle (in degreesj of the sector can be entered numerii.ilK Che button only 
becomes active when the first two points of the creation have been defined 

Position 

Can be used to enter the coordinates of a point numerically. 

Depth 

When creating a primitive with depth (e.g. cube), this button opens a dialog where the depth i nn I h 
entered in metres. This button is only active during the creation of a suitable primitive 

Outl. Depth 

When treating a primitive which has a depth, this button allows the depth to be defined vistutlh b\ 
drawing a line in a view window. This button is only active during the creation ol a suitable prlml 

Center 

This button places the next point in at the center of the points defined already in a creation proti 
For example, the second end of a culcone can be defined lo be centered over tin lirsi 

Example I: Create a iube with a depth of 0.1: 

- Select the function Create/Visibles/Cube 

Start cube definition by clicking once in a view window 

- Click the 'Depth' button of the ViewTool window and enter the desired depth ol the CUD* 
Complete the cube definition by entering the second point on a view window 

Example 2 Create a cone with a depth equal lo the width of the previously nv.il. d >uU 
Select Create/Visibles/Conr 

- Define the center and radius in a view window. 

Click the 'OutJ.Depth' button of the ViewTool window. This allows you to define the depth ol the cone 
by entering Iwo points in a view window. The distance between defined points will be used as a 
depth for the primitive to be created. So, drag two points From the previous^ reated cube. 
- Define the apex for the cone with a left mouse button elk k 

Example 3: Create a cylinder sector of 45 degrees: 

- Select Create/Sectors/Cylinder 

- Define center and first angle on a view window. 

Click the Angle' button of Ihe ViewTool Window and enter Ihe desired .ingle (451 degrees. 
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Example 4: Rotate objects 45 degrees; 

- Select objects to be rotated 

- Select the function Modify/Linear/ Rotate 

- Start rotating objects as usual by defining two points by clicking in any view window. 

- Click the 'Angle' button of the ViewTool window and enter the desired rotation angle in degrees. 

Example 5: Create a cone whose apex is positioned exactly at the center of the base circle. 

- Select Create/Visibles/Cone 

- Define the center and radius by clicking two points in a view window. 

- Click the Center' button of the ViewTool window. 

Example 6: Move objects exactly -0.5 space units along the V axis. 

- Select objects to be moved 

- Select the function Modify/Linear/Move 

- Start moving objects by clicking a point on a view window 

- Click the 'Position' button of the ViewTool window. This opens a dialog which shows you the 
coordinates of the last clicked point for example: 

X; 0.43 Y: -0.03233 Z: 

Add -0.5' to the X: field 

X: 0.43-0.5 

and click OK. 

Example 7: Create a cone whose apex is located precisely at the point (1,1,1): 

- Select Create/Visibles/Cone 

- Define the base circle as usual 

Click the 'Position' button and enter coordinates x=l, y=l. z=1. 



Create/ 
Structure/Link 

See Structure/Group below 

Structure/Group 



The system of how groups and links find their targets is based on the tag 'SIDE'. The target of a link 
relerence is determined by finding the first object with the same SIDE tag identifier, then searching 
from a minimal sub hierarchy containing both the link and the target. In other words, the target is first 
searched for in the same hierarchy level, then in its parent level and so on. 
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Duplicate identifiers usually don't cause problems because the object hierarchy determines how the 
references are resolved. For example, the Rightl.eg could be created by duplicating the I eftl eg; 
Legs 

LeftLeg 

mesh SIDE=leg 
group SIDE=leg 
RightLeg 

mesh SIDE=leg 
group SIDE=leg 

Problems may arise if a link and its target are duplicated into the same level as the originals 
Legs 

mesh I SIDE=leg 
group 1 SIDE=leg 
mesh2 SIDE=leg 
group2 SIDF_=leg 

In this case, both groupl and group2 refer fo mesh I, although the intention has cleaH) been thai 
group2 refers to mesh2. 

If a situation arises where a link/group points to another target as intended, Ihe problem i an bi tolved 
by defining a new, unique SIDE tag for both Ihe target and the link: select the link, then menu M< idif) 
Properties/Tags, select the SIDE lag and change it, for example, to 'SIDL=noprob!em , click < )K and 
then do the* same for the target. 



Structure/Method 



The Create/Strudure/Method dialog contains a new option 'Inherif. which is sei h\ uVt.nilt n ih<< 
option is unselected, lime modifications defined by Ihe method are not inherited to StH < essor 
methods, but are visible only inside the method. For example: 

Hierarchy Time lines 



Root PATHl I- -| 

cube PATH2 |- 

PATHl 

curve I 
PATH2 

curve2 

If the Inherit opium is set and you modify the time line of the PATH!. I'M I r ml! be afla led -is well. If 
you don't want this effect, just reset the Inherit attribute lor RATI 1 1 Then y iu ma) modify the time line, 
phase, frequency etc attributes of PATH I freely without clviii^ni: thr behavloi ol PATH2 in any way. 

The time inheritance feature is controlled by Ihe tag II.NI I whi. fl I an !>■ .isso, iated with all animation 
methods. If the value of this lag is 0, lime isn't inherited. If Ihe tag is nol ZCTO Ol missing time is 
inherited. 

For a list of new and changed methods, see the chapter 3 about the \iiim.ihon system. 
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CREATE/ 



Controls/Helix 



Name 



Angles are now used for all 'high level' functions, such as Create/Controls/ Helix. However, radians are 
still used internally, and all functions which directly reflect internal data structures (such as Modify/ 
Properties/Tags) deal with radians. 



Controls/Skeleton 



A skeleton is a special purpose primitive, which can be used to control other objects in combination 
with the skeleton method. 

A skeleton creation is started by selecting the Controls/Skeleton menu. It is defined by clicking the 
positions of desired amount of joints in a view window; a right mouse button click finishes the 
creation. During skeleton creation, initial angle constraints of joints are also defined. An angle 
constraint appears as a triangle at the beginning of the bone; the bone can be bent only so far that the 
previous bone stays inside the sector defined by the triangle. The angle constraints of the first bone 
can't relate to a previous bone, so they are defined in absolute space, unless you are creating a sub 
skeleton. In this case, the constraints are defined in relation to the end of the nearest bone end of the 
parent skeleton. 

When the skeleton has been defined, the skeleton attributes dialog is opened. 
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Fidelity 



The dialog includes controls for joint names, frictions, fidelity, angle constraints and bone orientation. 
The controls are: 

Skeleton type 

If the type of a skeleton is Tree', the whole skeleton will be moved if inverse kinematic requires the 

skeleton to reach further than its length allows. 



The dialog displays a list of joints. When you select a joint from this list, its name appears in the name 
edit box. You can rename a joint, for example, to call a middle joint of a 3 point skeleton elbow'. This 
helps to identify if quickly later. By default, the first joint (the point you clicked first when drawing the 
skeleton) is called joint 0. The end point of the skeleton has the highest ordinal number. 

Friction 

You can define a friction value for each joint of a skeleton primitive. If the value is zero in all joints and 
you pull the skeleton from the end point, the last segments of the skeleton are affei ted Rttl and 
inverse kinematics modification uses a minimal amount of segments to relocate Ihe end poinl ol the 
skelelon. If the value is greater than zero in all joints, all the skeleton parts become affei ted 
immediately. The maximal friction value 100 makes a joint rigid: the joint bends only il bending In 
other joints isn't enough for relocating the point modified by inverse kinematics. The friction is 
meaningless in three point skeletons, because there is only one point where the skeleton bends 

t 

Fidelity can be used to control Ihe orientation of skeleton targets with respect to the dun Ron "I the 
skeleton. The value of causes the orientation of the target object to exactly matih the orientation Ol 
the corresponding bone of the skeleton. The higher the value, the more the orientation is rictermil* d 
also by Ihe next and previous bones of the skeleton. This can be used to simulate skin behavioui foi 
example, when using skeletons for character animations. 

Note: the fidelity value of the last joint doesn't have any effect, because there is no bone Starting from 
that joint 

Another way to control fidelity is to use the FSKF tag, F5KF defines the same fidelity' propcil) AS On 
value in the skelelon attributes dialog, but the lag defines fidelity for each target separate!) thill 
allowing more accurate control. The value range of the tag is from to 1, corresponds to •■ Situation 
where the orientation of the target follows the bone totally 

For example, a spline-modelled arm, subdivided into cross-sections (poinl groups} whii h an 
controlled by a SKELETON method can be made to bend smoothly at (he elbow by adding the tag 
'FSKF=0.5' to the cross-sections at both sides of the elbow joint 

Angle Constraints 

Four angles are used to define constraints lor each joint. MinA and MaxA define the minimum and 
maximum angles of a sector in the plane in which the skeleton was created IrV I" me ilartlng From the 
selected joint can bend only inside Ihe defined sector. The angle of 180 degrees com sponds to Ihe 
direction of the bone which ends at the selected joint. 

MinB and MaxB define another sector which is perpendicular to the MinA MaxA sin tor together 
they define a rectangular space cone inside which the bone can move 

The constraint angles are defined interactively when the skelelon is created and they may be adjusted 
later with the sliders in the skeleton attributes dialog. 

Note: MinB-MaxB sector can't be defined during the interactive I nation process, and therefore MinB 
and MaxB are bolh set to 180 degrees by default. This allows Hie skeleton to bend only in the plane in 
which it was created. 
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Sub skeletons 

Skeletons can contain sub skeletons. When a sub skeleton is modified by inverse kinematics, the 

parent skeleton is also affected. 

Hierarchical skeletons can be created exactly the same way as non-hierarchical skeletons; just set up 
the hierarchy, and when the animation is played for the first time, the target objects are automatically 
fixed to the skeleton. 

Sub skeielons can be attached to any joint of the parent skeleton and the number of sub skeletons 
isn't restricted in any way. A hierarchical skeleton system is glued' together automatically when the 
animation is refreshed/played for the first time The sub skeleton is attached to the nearest joint of the 
parent skeleton. 

Mote: the sub skeleton isn't pulled to the joint of the parent skeleton but remembers its original 
displacement. If an exact match is desired, use dragging to position the firsl point of the sub skeleton 
on the desired joint of the parent skeleton. 

II the type of the sub skeleton is 'Fixed', the skeleton will always remain attached to the parent skeleton 
II the sub skeleton is Free', it will be pulled away from the parent skeleton if the parent is fixed and the 
inverse kinematic requires the sub skeleton to reach further than its length allows. eg. an arm can be 
made to leave the body in order to reach aw object. 

To modify hierarchical skeleton systems, the uppermost skeleton (root skeleton) must be selected. 

When creating sub skeletons, the constraints are automatically defined relative to the parent skeleton 

Example: Create a hand 
Create a skeleton to represent a shoulder, elbow and wrist 

- Make the created skeleton the current level (double dick the name of the skeleton in a select 
window). 

Create live sub skeletons to represent the fingers. Note how constraints for the first joint are defined 
in relation to the parent skeleton. 

- Select the 'shoulder -elbow-wrist skeleton (the parent skeleton of fingers) and apply Modify/Special/ 
Inverse Kinematics to the wrist. 



hierorihiial skeleton 
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Fractals/Landscape 



Settings defined in the Landscape dialog can now be saved and loaded. The system is similar to 
material or grid handling. In other words. You can create a list or a 'library' of I rat l.il settings, The File/ 
Project/Save Sections dialog contains a checkbox Landscape', which can be used to save landsi <ipe 
libraries separately to disk. File/Projects/Insert, Replace and Save automatically load and save the 
contenls of landscape libraries. 

To create a collection of fractal settings: 

Use the Fractals/Landscape function to experiment with parameters. When yon gel -1 suitable reSuJI 
enter a name into the name edit box of the landscape dialog and press the Save tuition Ihi . .nl.L. .1 
new entry to the memory resident landscape library. Then continue experimenting and whenevei you 
gel a good result, give it a new name and hit Create to store the parameters. 

You can retrieve sellings of a previously created landscape by pressing the Load button and b> 
selecting the desired entry from the lisL The Delete button allows you to remove entries from tin 
landscape library. 

When an appropriate landscape collection has been defined this way, select the menu file projci I Mid- 
sections, clear all sections except landscapes' from the section selector, dick OK. then define .1 
suitable file name to store' the collection with the file selector. 

You can reload a landscape collection with, for example, the File/Projet l/lnsert Sei lions fum Hon 
Remember to check 'Landscapes' when using this function. 



Fractals/Tree 



The procedures to create, save and load fractal tree collections is similar to fractal landsi ape handling 
as described in the Fractals/Landscape section, but use the Fractals/Trees menu for tree 1 rcation and 
when loading and saving tree libraries, use the Fractal Trees box in the projei t load and m inn. 

selectors. 



Modify/ 

Properties/ Attributes 



The Modify/Attributes dialog has a new checkbox Bounding Box t lu < king it replai es the wire frame 
representation of selected objects with a bounding bo*, which draws nmih Lister II the selected object 
is a level, then a single bounding box which surrounds Ihe entire level ts 1 reated 



Properties/ Animation 



See Create/Structure/Method for information about new attributes 
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MODIFY/ 



Properties/Skeleton Attr. 

Sec Create/Controls/Skeleton menu in this appendix lor a detailed description of skeleton attributes. 

Properties/Geometry 

This function opens a dialog which can be used to view and edit the geometric properties of 
primitives. Absolute space units (meters) and degrees are used 



The geometry dialog 




£ 0.0968385 



OK 


SWp 


! Cancel 



To use this luiu lion, select primitives and select this menu. This opens a dialog displaying a list of the 
geometric attributes of the first selected primitive. You can select the attnbute you want to modify from 
the list and change its value using the XYZ fields. Clicking OK confirms the modification and the 
function proceeds to the next selected primitive Pressing SKIP' ignores modifications of the currently 
displayed pnmilive and the function proceeds to the next primitive. CANCEL stops the function. 

When a primitive type which may include a variable amount of point data is modified, the dialog 
displays either one U' slider or two U and V sliders. Wilh these sliders, you can select the point to be 
modified 

Example: to move a sphere to a new position, say x=0.5, y=0, z=0: 

- Select the sphere 

- Select the function Modify/Properties/Geometry 

- Select the attribute Center from the attribute list and enter the desired coordinates for the center 
point 

The primitive type specific attributes which can be modified with this function, are: 

Rectangle- 
depth 
pft pi p2 



Cube: 



depth 
pO, plp2 



'dvecf vector (direction and size) 
three points defining a rectangle 

- extrusion vector 

- three points defining the base 



Pyramid: 

apex 
p0,pl,p2 

Ellipse: 

depth 
center 
a,b 

Cone: 

apex 
a, b, c 
p, m, n 

Ellipsoid: 

center 
a, b, c 



- position for apex 

- three points defining the base of the pyramid 

- 'dvecf vector 
(.enter 

- axes 

- the top of the cone 

- axes 

- point p and two vectors m.n define a plane which cuts tin* infinite conn 
to a finite solid (m cross product n is the normal vector ol this plane) 

- center point 

axes. II these are perpendicular to each other and haveequal li nglha 
the shape is a sphere. 



Hyperboloid, Cutconc, Cylinder, Ellipseg: 
center -center point 

a, b, c - axes defining a quadric 

pi ml, nl. p2, m2. \\2- two planes defining the end faces. 



Offset Aimpoint: 
position 


clear 


Viewpoint: 

posilion 

horiz 

direction 


- position of the camera 

- horizontal lilt' direction vector 
camera direction. 


Coord.sys: 




origin 
a, b, c 


- posilion 

- axes 



Line: 



Spline: 



pO, pi,... pn 



- the points of the line 



p|0\0J. p|0,1|, ... p|n,nl control polygon points 

Polygon: 

stick - 'dvecf boolean volume direc lion 

plOLpMUpM the shape 

Polyhedron- 
depth Extrusion vector 
pl°L pi 1 1. • pln| the base shape 
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Polymid 

apex 

pIOL pll], plnl 

Culpolymid: 

baselOL baseM. ... base|n 
ioplOI, topUL ... loplnl 



- the top 

- the base shape 



- base points 

- cover points 



Tnset 



pO,pl,...pn 



- the points of the mesh 



Properties/Fade 

Real 3D's Rendering engine now recognizes a new object attribute 'Fade'. This attribute can be defined 
with the Modify/Properties/Fade menu or with the Tag editor. The attnbute is stored as an integer tag 
'I FAD nnn' where nnn is in the range between and 255. 

The Fade attribute makes an object translucent The minimum value doesn't affect the object at all, 
whereas the maximum value 255 makes the object completely disappear from the rendered image, as 
if it did not exist at all. Also, the object's shadows and reflections are faded. 

The Fade attribute may be used for example to easily fade objects in and out in animations, by 
morphing the tag value. Using the fade attribute is different from using transparent materials: 

- Translucency created by fade renders much faster than real 'optical' transparency. 

- Fade has no refractions or reflections. 

- 100 % full transparency can also be achieved with colored objects. 

Special/Reflect 

This function moves selected objects so their reflections will be seen on a surface at a position on the 
object surface pointed to with the mouse. 

For example, when you want to move a light source to where it's specular highlight will appear in a 
certain position, select the light source, then select this function and click in the position where you 
want to have the center of the highlight. If the dick doesn't hit any object, the light source will not 

move. 



Freeform/Type 



This is a useful feature when handling converted (imported) objects. The Modify/Freeform/Type dialog 
contains a 'Clockwise normals' option, which may sometimes produce better shading than the default 
automatic orientation method, which tries to set the face normal directions by checking the adjacent 
face normals. Which method is better depends on the modeller which created the object and the 
conversion software used. 



46 



CIIAIMLR 2" MENU FUNCTIONS 



MODIFY/. VIEW/ 



Freeform/Round 

The function Modify; Freeform/Round can be used lo round polygonal lines, b-spline I urns, polygons, 
polyhedrons, polymids and culpolymids. 

To use this lunction, select the desired points by placing them on the vector stack (drag around them 
while holding down the shift key}. Then select the function Modity/freeform/Round and define the 
rounding radius and the number of points to be used for rounding. 



Rounding a 
polyhedron 




Freeform/Convert to Triset 

The Convert to Triset function < onverts the selected objects to Irisets, which can then be exported 
3DS for example. Unlike the old Triset from mesh' function, this one is based on the real shap 
Spline, quadric etc.) and can handle all kinds ol objects. 

Note: Boolean Operated objects are not yet supported They are exported as il lh<\ were nol Operated 
at all. 

Freeform/Surface to Groups 

This function can be used lo subdivide a mesh ora line to suitable sub groups In use tin inn. tfon 

select freelorms and then this function from the menu Enter the size ol groups lo the UandV fields 
and click OK. 

When you modify lines with this function, the V size is nol Used, 

For example, you can subdivide a 8'8 pixel mesh to sixteen subgroups of 2 ' points each 

Freeform/Fideltty 

Skin behaviour of freeforms controlled by skeletons can be defined using so called fidelity attribute, 
which can be attached both lo skeleton joints and to skeleton targets See the description of skeletons 
for details. 
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VII w/ 



VIEW/ 



Freeform/Fidelity function defines the fidelity attribute (or the selected points of (he selected freeforms. 
To use the function, select some freeforms, then Shift-Drag some points (you can also use Lasso 
selector) and select this function from the menu. Define the fidelity value and click OK. 



View/ 
Type/Surface 

When this mode is set, 3D coordinates are automatically defined by mouse inpul. The mouse position 
is actually moving along object surfaces instead of along the input plane. This function is very 
powerful. For example, the Type/Surface function makes it easy to position objects accurately on 
freeform surfaces or blend B~Spline surfaces. 

Camera/Camera View 

Camera view is now updated interactively when you move camera objects provided the View/Camera/ 
Camera View option is set and the window with camera view isn't the active one. 

Previously, camera view was updated only during animation playing. 

In this example, we will use two view windows. The camera object is modified through one view 
window, while another view shows how the scene looks through the camera. 

- Open two view windows. 

- Create a camera object with View/Camera/Define Camera. 

- Set View/Camera/Camera View for the second view window. 

- Modify the viewpoint or the aimpoint object through the firsl view window. The orientation of the 
second view is automatically updated while you move the mouse. 

Render/Settings 

Auto Box Rendering 

The Render settings dialog contains an Auto Box Rendering' option. This switches on the new box 
rendering feature and trie', to optimize the use of the processors internal cache memory. The higher 
the image resolution, the larger the time saving obtainable by this optimization. The speed 
improvement can be significant, especially on a PC, delivering up to twice the rendering speed. It 
should be noted that when rendering simple scenes to a disk file, Ihe overhead of extra disk operations 
may actually slow rendering. 

Interlace fields 

The Render settings dialog contains a new control for field rendering. If the Interlace Fields' option is 
selected Real 3D automatically interlaces every two fields into a frame which is saved, and then deletes 
the fields. 



Super sampling 

This is another new render setting. When this option is selected, Ihe X- and Y resolution fields define 
sampling density on sub-pixel level Instead of rendering several pixels by one sample, which is the 
normal function of the X- and Y-resolution fields, several samples are taken from one pixel when 
Super sampling is selected. 

For example, if super sampling is set and X and Y-resolution are both two, the result is the same as II 
you rendered a 4 times higher resolution image and Ihen scaled it aRerwards by averaging eA h I 
pixel group into one pixel. 

This feature can greatly improve image quality when the scene contains small details or dense texture 
maps. The disadvantage is slower rendering time: it takes almost four times longer Lo rendci an image 
with 2*2 super sampling. 

Note: if you use super sampling to improve image quality, you may safely lower Ihe normal anil 
aliasing level. Typically anti-aliasing factor two is enough when super sampling is applied 

Alpha channel output in IFF file rendering 

Iff rendering to a file with Alpha output selected now produces an 8 bit alpha file Instead ol I bH mask 
file. 

JPEG support 

II is now possible to render JPEG formal images. 

Saving and loading render settings 

Render settings can be named, saved and reloaded in a similar way as grids, fractal settings and 
materials. You can define a memory resident collection of individual, named rendei settings with h 
may be saved to disk as a render settings library. Whenever you need good tend© settings you on 
reload this kind of library and select a suitable entry from it instead of redefining the settings from 
scratch. 

The render settings dialog contains a 'Name' edit box where you can define a name fbl tbfi I urrentl) 
edited render settings. Pressing the Save button adds a new entry lo the settings BbrW) You i an use 
the Load control to load previously defined settings back to the dialog. Ihe Deleti butt in is to remove 
entries from the library. 

A render settings library can be saved to disk with the File/Project/ Save S» b'ons Inn, lion il you ( heck 
only Ihe Render settings section. Settings can be reloaded with Rle/Proja I Insert Replai i Insert 
sections or Replace sections functions. 

Pressing the OK button in the render settings dialog doesn't update pro iousl) li faded nmder settings. 
Use the Save button to write modified settings to the settings library. 

Mote: it is usually not necessary to define render setting libraries Each view window Includes its own 
render settings and when you save a project the settings are saved with View windows. Render setting 
libraries are necessary when you intend to re-use carefully defined sellings from other projects or 
want to copy settings from owe view window lo another one. 
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VII w/ 



Post effects 

Real 3Ds post effect system makes il possible lo build a list from post effect modules' which each 
manipulate the rendered image This way, a variety of easily controllable, interesting effects can be 
added to images quickly. 

Some post effects are computed automatically by Real 3D. You can add extra 'plug in' post effects to 
Ihe program This happens by placing a library which defines such effects into the Classes' directory in 
the Real 3D home directory. This way, the post effect library is automatically installed whenever Real 
30 is started. Of course, the 'Classes' directory may contain several post effect libraries. It is also 
possible to open a new library without auto installation at program startup time with the File/ 
Windows/External Classes window. This window can be used to select and open extension Kbraries for 
Real 3D. 

The render setting dialog contains a POST EFFECTS' button. This button opens a dialog where Ihe 
post effect list can be constructed and edited. Each view window can have its own post effect list. 



IIQCC&5QI5 



glow 

log 



The post fffrti dialog 



glow 









PxH 



The Post effect dialog has two list boxes. The left one displays all installed post effect libraries You can 
select a library from this list If you then press the Create' button at the bottom left corner of the 
window, a new effect is created and inserted to Ihe view window's post effect list. You may then edit its 
properties by pressing the Edit' button. This opens a new dialog, whose contents depends on the 
effect in question. See the effect library specific documenlalion for details. 

I he list selector al Ihe right side of the window displays the post effect list created so far. You can 
activate a list item and edil it, or delete it with the 'Delete' button. The image which Ihe Tenderer 
computes is processed by the effects in this list The topmost effect receives the image data first, 
manipulates it. sends it to the next effect and so on. This means the order in which the effects are 
computed may have some importance. When you create a new effect, it is inserted after the currently 
selected effect. If none of the effects are selected (e.g. when the post effect dialog has been just 
Opened), the newly created effect is inserted to the beginning of the list. 

If a particular posl effed has been inserted to the post effect list, but the corresponding effect library 
isn't opened when rendering starts, Ihe effect will not be active. For example, this may happen if you 
send a project to another Real 3D user who doesn't have the same effect libraries installed on his/her 
system. 
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Glow 

The glow effect processes glow size and brightness material properties. 

Glow effect has two global attributes: an Additive option and a Fixed size option 

Additive: 

When this button is set, the brightness of overlapping glow areas is combined to a higher brightness 

value. Additive glow usually creates a brighter glow effect, but sometimes strong glow brightness 

variance may be undesirable. Note also that additive glow makes the obje I to which il is applied 

brighter, so usually the color of the glowing object may be quite dark. 

Fixed size: 

When this option is set, the glow is computed as a camera effect', and glow size doesnl depend on 
glow source position, distance from camera or image scale. This kind of glow is slight!) fa&tei to 
compute than the default 'space volumetric' glow. 

Distance anti-aliasing 

Distance blur is a simple post effect which can be used to improve anti-aliasing ol dlstanl objtt tl Ihe 
effect smoothens the image output depending on Ihe distance from the camera 

This effect has one attribute. Distance blur'. It defines Ihe blurring sensitivity. The higher Ihe v.ilur the 
closer objects become blurred. A good default value is 30. 



Render/Export DXF 



This function exports polygonal objects and freeforms as surfaces in DXF formal Quodrii primitives 
are exported as curve data corresponding lo the wireframe representation 



Drawing Settings 



The new, fast backdrop image blitting feature is enabled by the "Bit Backdrop' - hoi kbox in the 
Drawing Settings dialog. 

To use this feature, use the Render Settings dialog to deFme the Backdrop Image file name vt the Rlt 
Backdrop" checkbox in Ihe Drawing Settings dialog. After that, Real 3D will draw tl,< defined Ifnagt in 
Ihe view window before wireframe refreshes. The image is rendered in .1 similar wa> as the bai kdrop 
image is in ray trace rendering. In other words it is rescaled to match the dimensions ol the ie* 
window 

This function can handle all kinds of images supported by Real 3D. II the diaplfl) mode doesn't 
correspond to the image, conversion is applied. 

The purpose of this feature is to allow accurate perspective mat* hing rati isi oping et< 
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AN I MA IT' 



Animate/ 
Create/Keyframe 



Builds up a hierarchy required for keyframe animalions: 

- Creates a new level, and puis the selected objeel info the level. 

- Creates a keyframe method 

- Defines the first key to represent the current state of the selected object for the keyframe method. 

Select the object to be animated before you activate this function After you apply the function, yon < an 
continue by making the created keyframe method the current level and use the key editor (Animate* 
Edit) to define more key frames. 
See the tutorials, Animate/Edit and chapter 3 Animation system' for more information. 



Create/Inverse Kinematic 



Select a skeleton and then this function. Select suitable path options and draw a motion path lor a 
joint The function creates a new level copies the skeleton into it and creates an inyersed kinematics 
method with the defined parameter curve. The defined path is automatically associated with the 
nearest joint 

If you need to define more than one inversed kinematic curve, don't apply this function again to the 
skeleton, but make Ihe newly created inversed kinematic method the current level and create more 
curves inside the method level. 

Create/Skeleton 

Builds a hierarchy where the selected objects are controlled by a simple skeleton method. 

To use this function: 
Select the objects you want to control with a simple skeleton method. 
Pick the menu Animate/Create/Skeleton. 

- Draw a skeleton primitive in a view window. 

- Define suitable skeleton attributes in the opened skeleton dialog. 

This function automatically maps targets which are freeforms onto the skeleton as one point sub 
groups. The purpose of this is lo allow 'skin' like control of freeforms (usually some fidelity needs to be 
added to the points near the joints). If you want to control a freeform as a one single block, put it 
under a level object before you apply this Junction to the level. 

The function doesn't immediately fix the targets to the skeleton. The targets become attached the first 
time the animation is played/relreshed. The reason the function operates in this way is to allow editing 
Rne adjustments of the defined skeleton primitive and definition of possible sub skeletons before the 
targets become attached. 
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Create/Shrink wrapping 

This menu function creates an animated shrink wrapping effect Use the function m the following way: 

- Select the object, against which you want to shrink another obje 1 

- Multi-select (keep the shrink target selected!) Ihe objeel to be shrunk, for example .1 freeform mesh, 

- Pick this function Irom the menu. 

- A dialog is opened. Select the shrink wrapping type, If you use parallel shrink, you may also wld I Ilk- 
cumulative option. Click OK 

- Depending on Ihe shrink wrapping type. Real 3D waits you to define some parameter information, II 
you selected cylindrical or spherical shrink wrapping, define first the shrinking (enter by .. mou* 
click and then draw a line defining the amount of shrinking. If you selected normal 01 parallel shrml 
wrapping, jusl draw a line defining the amount of shrinking (and the direction in parallel wrapping] 



Edit 



You no longer have to select a animation method prior to using the function Animate/Edit the 
function still attempts to open a method sensitive editing window, but if selected objei is don 1 conl Hn 
any animation methods, the key editor is opened instead. 

For more information about the key editor, see chapter 3 of this appendix Animation system 



Extras/ 
Vectors/Deselect Group 



This (unction removes any points from the vector stack which are also in seta ted groups when the 
(unction is used. The purpose of this function is to make it easier to subdivide mmple\ liv, lorm 

objects into subgroups so all points of the freeform object in question belong ne flndonh one 

group. 

Example: let's subdivide a B-Spline object into two separate groups: 

- Load or create a b-spline object 

- Shift drag or lasso select some points of the B-Spline object and create 1 group wttll the luiulion 
Create; Structure/Croup. 

- Now select all points from the b spline objeel, for example by Shift dragging Make sure Ihe 
previously created group is selected and then use the Desel© I Croup turn Bon 

- Select Create/Structure/Croup. The new group contains all points except the points of the first group. 



CHAPTER 2\ MENU TUNC! IONS 



53 



EXTRAS/ Si MINGS' 



Repeat Last 



The function Extras/Repeat Last re-executes (re-activates) the previously executed function. The hot key 



is ■S*. 



3. Animation system 



Show selected objects -hotkey 

Selected objects can be shown in a view window as flashing wireframes by pressing the 0' hotkey on 
the numeric keypad. This key binding is built-in. 



Settings/ 



Attributes 



General 



The Settings/ Attributes function can now be used to define default names and depths for all objects. 
Sometimes this may be extremely useful. For example, if you are designing kitchen cabinets, it might be 
a good idea to sel Ihe initial depth of the cube primitive to 15. because 15 mm. is the thickness from 
which the kitchen cabinets are most commonly manufactured. 

The changed primitive attributes can be saved with a project or to an environment file (for example to 
startup.r3d), with for example File/ Project/Save sections ( Primitive Attributes section should be 
checked). 



A "No RPL busy requester" checkbox has been added to Settings/General. If it is checked, no busy 
requester is opened when a named macro is executed, or when an RPL file is otherwise loaded. 



The key editor 

Many of the new fealures have been integrated into the key editor window, whit h is opened with the 
menu Animate/Edit. 




The key editor 
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Envelopes 



IliMiibiiln 



* tnv. Key* I Closed f Llnccr 

r AutoTrai* r Periodic ft FJ Spl.t-e r Discrete Delete Key] IpievKcy 



Next Key 



Edl' i MM 

3 r r 



Ihe window consists of Ihe lollowing fields: 
Frames: 

It is now possible to move in lime by < lit king the desired frame number vvilh the left" mouse button 
Knot sequence: 

This is Ihe raised bevelled box just below Ihe 'frames field II shows the knot ■,,(„■■ I the method 

currently being edited. In \t2, this was only used to control the morphing method Now handles all 

path oriented methods and the new keyframe method 

Invisible: 

This check box makes the method and any other objei Is within the method hierarchy either Wireframe 
Visible or Wireframe Invisible. 

Auto Track: 

This check box enables Auto scrolling within the key editOI Window during animation playback. 
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IMl REV mnoR 



THE KEY 11)1 TOR, tNVFIOPES 



° Se " Closes the evaluation of a motion. For path animations, this is equivalent to applying the Modify/ 
Freeform/Open/Close function to the parameter curves. 

e "° Defines periodic evaluation, which makes dosed motions smoothly repeatable. See Animate/Create/ 
Path; Periodic. 

Linear/B- Spline/Discrete: 

This defines the type ot interpolation used. 

Pt °This cycle gadget defines the method to be created. If the method is Transform', a time transformation 
is created and inserted at the beginning of the current level. 

L Creates a method defined by the Method' cycle gadget The Function is identical to items found in the 
Animate/Create menu. 

Envelopes: 

Opens the envelope editor. See the description later in this section. 

' Redistributes the knot sequence uniformly over the time and causes target objects to spend equal time 
between all subsequent keys/knots. This also handles dosed motions appropriately. 

Create Key: ,. ,, 

This creates a new key object/knot point If the method is keyframe or morphmg a new key object is 
created. If the method is one of the path oriented methods, a new knot point is created for the 
parameter curve. 

Note: this function can only be applied when there is no key object/ knot point which corresponds to 
the current lime. 

Delete Key: 

This deletes the current key object/knot point. This function can be applied only when the current lime 

matches an existing key object/knot point. 



Edit: 



Next: 



Prev: 



Plays the animation to the next key-object/knol point It the animation is played to the end, this button 
is disabled. 



Finds the previous key object/knot point. 



These buttons can be used to play the animation backwards and forwards, and to stop playback at 
any point. 



Pivot: 



When editing keyframe or morphing methods, the 'Edit* button prepares the system for key editing. If 
the current time matches an existing key, this burton selects the key so the modifications are 
performed for the correct object it the lime doesn't match any key, no keys will be seta ted and only 
the target object will become selected. 

Selects the first object in the current level, and calls the Modify/Properties/ COG function, so you ran 
redefine the COG with a left mouse button click. This is convenient when creating keyframe 
animations. The keyframe method rotates the target object around the COG (pivot] point 

Whenever full rotation conlrol is needed, il is best to define the pivot point, because the default pivot 
may not be suitable. The pivot point should be defined before the keys have ben , iv.it. ,1 !>■■, ausc 
otherwise, redefinition of the pivot may change the animation quite radically, requiring a lot of r. 
editing. The pivot point definition may be done conveniently with this button immediate!} aftei a 
keyframe method has been created with the Create button of the key editor. 

To edit an animation method with the key editor, make the method the current level 



Envelopes 

The envelope editor is opened by clicking the Envelope' button in the key editor window, I Hmcnsloru 
(x t y. z) can be switched on separately with X, Y and Z check boxes. The envelop.- edltoi shi 
envelopes of the current level, provided it is a path oriented or a keyframe method 



The envelope editor 




+/- buttons on the right corners are used to change the minimum/maximum limits the envelope editor 
is displaying 

To modify an envelope, just click the desired 'knot point' and move il to a new position 

Note: you cant modify knots in the horizontal (time) direction Use foe key editoi lor Ihis purpose. 

While editing knot points, you can enter the position numerically In the Value string gadget. 

It s also possible to move more than one knot by dragging 

The Update' button updates Ihe animation system so yon can see the effe< I ot the envelope 
modification in the actual scene. 
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INVIIOI'IS 



PATH ANIMAJIONS, KEYKRAMC METHOD 



Four envelopes are available for the keyframe method. 

Translate (move) 

- Scale 
Rotate 

- Shear (skew). 

Translate shows the relative motion in object's space, i.e. how much the object is displaced from its 

original position. 

Scale defines how much the size of the object is changed. A value of 1 means no change. A value of 1 

means object is mirrored. A value of 2 means the size is doubled. 

Rotate is expressed in degrees and is relative (it shows how much the object is rotated from its initial 

state). 

The following figure shows how shear is defined. 




Shear is defined by three angles 

a* defines how much the y component of the object is skewed towards the V axis. 

ay - y towards the '/' 

az - z towards the V 

The envelope window may also be used to modify paths of all path oriented methods such as: 

- sweep 

- size 
stretch 

- inversed kinematics 

- move 

- direction 

Only the translation envelopes of the abovemenlioned methods can be edited. 



Path animations 

Polygonal and B spline curves now contain so called 'knot sequence', which can be used to define 
how the time is distributed over the curve. In other words, you can define the frame in whi( h the target 
object reaches each knot point of a curve. 

The key editor can be used to create path oriented animation methods and to edit knol Sfiquem es \ 
suitable animation method can be selected from Ihe Method' list and the 'Create button * Kvates a 
method creation process, in which a curve is defined and drawn in a view window 

To edit a path method with Ihe key editor: 

- Open the key editor from the menu Animate/Edit. Make sure the path method isn I the i urwil level 
otherwise you will get a path edit dialog 

- Make the palh method the current level. 

- Next and Prev buttons of the key editor can be used to jump from one knol point to anothei 

- Create Key and Delete Key buttons can be used to create/delete knot points to/from motion paths 

- The timing can be adjusted by moving the knots along the time line. 



Keyframe method 

The syntax for Ihe keyframe method is as follows: 



Root 



target 




KFVRFAMK 



^^^ 






Original 


Keyl 




KeyZ.. 



In other words, the shape of the target' is defined by applying a transformation to Ihe i iriglnal objft I 

The transformation is defined by interpolating a number of keyframe method Spei Ifii lags av ntcd 

with 'keyl. key2, ...keyn' objects. 

Four tags are used to store the required transformations to key obje< Is 

VMOV This lag defines how much the target object is displaced from Ihe original objed in \ 
y and z directions. 

-This lag defines how much the target object b rotated In x \ and / directions 

- This defines how much the target object is scaled in its v \ and / dirtt lions. 

- This defines how much the object is sheared (skew transformation). 

IMIT tag defines whether to use linear. B-splinc or discrete interpolation Ihe II LG tag selects open/ 
closed interpolatioa See the morphing method description for more Information 



VROT 
VSCA 
VSHE 
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MM KAMI METHOD, MORPHING Mil HOD 



MORPHING MIIHOD 



The pivot point about which rotations are interpolated is defined by the COG of the original object i.e. 
the first parameter object of the keyframe method. The default COG value can be redefined by 
applying the Modify/Properties/COG function. 

Note: the easiest way to create keyframe animations is to use the key editor, and normally you don't 
have to worry about the lags mentioned above. 

To create a keyframe animation: 

- Open the 'Key Editor' window by selecting the menu Animate/Edit. Set the 'Method' selector to 

Keyframe'. 

- Select an object to be animated lor create it) and click the 'Create' button. This creates a keyframe 
system which consists of one key frame. 

- To create more key frames, move to a desired position in time by clicking the desired frame, click the 

Create Key button and modify the new key object 

- In order to modify other key frames, use the 'Next' and 'Prev' buttons to select the desired key. Note 
that these functions automatically select the target object and the correct key frame object, so you 
can instantly start editing the key. 

- Only linear transformations (Modify/Linear menu) tan be used to modify key objects. Functions 
such as Bend and Twist' can't be used (use morphing, if you need non-linear transformations). 

- If you want to edit a previously created key frame method, make it the current level and press the 
Edit' button. 



IFLG flag bits are: 

- Set for closed, reset for open evaluation 

2 - If set. materials are morphed 

3 - If set, geometry is morphed 

4 - If set. tags are morphed 

5 - If set. object colors are morphed 

Depending on which data is selected by the abovementioned bits, the hierarchy of the target phi-, I 
and key objects need not match exactly If geometry morphing is selected, then the primitives i >i keys 
and their hierarchical grouping must match the target object exactly, although there ma) I- 
additional default mappings in the target object, because there is no geometry asso, iated with thai 
mapping type. For example, the following hierarchy is valid" 







Root 














target 


MORPHING 




^^ 


^" 




cube 


default (T) 


cubel 


cube2 



If color morphing is selected, the primitive hierarchy must match exactly, except (here mfl) h. 
additional level objects at the end of hierarchy levels, because level objects don't I ontain coloi data So 
this is again a valid hierarchy: 



Morphing method 

The MORPHING.CLOSED method no longer exists. There is only one Morphing method available. 

Open morphing is used by default. Closed morphing can be selected by editing the method with Ihe 

key editor (Animate/Edit), which contains a Close' button for this purpose. 

Internally, the IFLG tag is used to define whether or not open evaluation should be used. If the first bit 

(value 1) is set closed interpolation is used. 

The morphing method recognizes a new interpolation type: discrete. The discrete interpolation 

changes the target object only at key frames. This could be used, for example, to create camera cut 

effects. The tag IMIT defines which interpolation type is used. Possible values of the IMIT tag are: 

- Linear interpolation 

1 Cubic B Spline interpolation 

2 - Discrete 

The interpolation type can be selected in Ihe key editor. 

Another improvement is that all tags are now morphed (light source brightness etc), Furthermore yoi 
can selectively morph geometry color, lags and materials. This is controlled by the tag IFLG associate- 
wilh Ihe method object. Again, the key editor includes the necessary controls. 







Root 














target 


MORPHING 




'-"\ 


^" 




cube 


level 




cube! 


cube2 



This doesn't work if either geometry or color morphing is selected: 




Material morphing van usually be switched off because il the keys .ire copies ol the target object all 
the mapping objects refer to the same materials in the material librarj and morpMng doesn't have any 
effecL So Ihe only consequence of switching material morphing ult is fastd animation playback For 
example, in the following hierarchy, all mapping objei Is m.ip refer to the same material mat': 



Hi 
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mokhhnc Minion 



SKELETON METHOD, SIMFI I SRETON METHOD, INVERSE KINEMAIIt Ml II 



ion 



target 




cube map(mat) keyl 



cubelllmap(mat)1 cube2 map(mal) 



Morphing materials makes sense only if each of the materials is different, Le, three separate material. 
matt. mat2 and mat3 are used: 




cube I map(mat) keyl 



cubell lmat)(mal2)H cubc2 map(mal3) 



Tag morphing has no requirements for hierarchy matching The animation system scans the h.erarchy, 

picks objects according to their position in the hierarchy and morphs their tags. This process is 

continued until a key doesn't define the currently morphed target tag, i.e. a hierarchy difference is 

detected. A possible difference doesn't produce an error message, the rest of the tags of the target are 

just left unmodified. 

Note, string tags (of the form Sxxx=~] can't be morphed. 

For example, tags of the root level of a compound object can easily be morphed as follows; 





1 Rout 1 




target MORPHING 




l^vl ^ ^> , 


subl 


sub2... level! ' evel2 



In this hierarchy, level objects 'target', 'level I' and level? contain the tags to be morphed. Level 1 and 
Ievel2 can be empty levels. A useful application is morphing the fade attribute defined by IFAD tag this 
way 



Skeleton method 

The skeleton method handles hierarchical skeleton primitives. The actual syntax is exadh the same as 
in v2. 



Root 



targets 



SKELETON 



some 



left leg rightleg 



Simple skeleton method 

In this version, the simple skeleton method automatically maps target freeforms .is one point ub 
groups onto the skeleton. 

The parameter of a simple skeleton method may be a hierarchical skeleton. 

Inverse kinematics method 

The inverse kinematics method can now take several parameter curves whi< h are automata alh 
attached to the nearest joints of the target skeletons. 





Root 








skeleton 




INV KINEMATIC 




cur\ 








i'l| curve2 [ i urvr.i 



The tag IIND, when associated with parameter curves of the inverse kincrrwtii s methi id defines the 
joint to be affected by the curve in question. In addition to this inverse kmem.iti< s also needs to know 
to which skeleton the joint index refers (thanks to the new hierarchical skeleton feature the target 
skeleton may be hierarhical; in which case there arc actually several skeletons] Che SIDI lag is used 
for that purpose. For example, ifcurveT' should define a motion for the third |oinl ol ske!2V there 
should be the following tags associated with 'curvel 

IIND=2 (third joint is the last - default] 
SIDE=xxx.x 
and the lag SIDE=xxx.x' must also be attached lo ske!2l 
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SURFACI Mllli(H), SHRINK WRAPPING METHOD 



SHRINK WRAPPING METHOD 



Note these tags are defined automatically when the animation is played or refreshed lor the first time. 
If you don't want automatic definition, add an ISKE=2 lag to the method before you play the 
animation. If you want the program to redefine these tags, delete the ISKE tag. 



Surface method 



This new method is based on collision detection. The method makes an animated object automatically 
travel along a surface. The motion is generated by user defined friction points': the method doesn't let 
these points slide along the surface, but moves the target object instead. 

The surface method takes three parameter objects; 

This defines the direction for gravity. For example, you can draw an axis (Create/Controls/Axis) to 
define the direction. Note that this parameter may be animated so Ihe direction of grav.ty doesnt 
remain the same. 

2. Surface: 

This represents the ground. This could be any object, such as a mesh surface. 

3, Links: rr 

A level object which consists of a number of links. Links must refer to offset pr.m.tives .n the target 

object. These offsets are taken as 'friction points'. 



center 




Shrink wrapping method 

This method is the animated version of Modify/Special/Shrink wrap (unctions. 
The syntax of cylindrical or spherical shrink wrapping is as follows: 



Root 



SHRINK WRAPPING 




- This can be any evaluable object (such as an offset or a curve} and defines Ihe center 
for shrink wrapping. This corresponds to the first mouse click in the interactive shrink 
wrapping functions. 

- This defines how much the object to be shrunk is scaled' Normally, this should be an 
axis. The end points of the axis correspond to the second and third mouse i In ks in the 
interactive shrink wrapping functions. 

This defines the 'original shape' of the target object. The hieran hit al strut lure must 
match the target object exactly. 

- this corresponds to the first selected object in the interactive shrink wrapping In Othfl 
words, 'orig' object is shrunk around this object. 

Parallel and normal shrink wrapping arc animated with the following, slightly simpler hieran h) 



howmuch 

orig 
against 




howmuch] | orig | [against | 



In parallel and normal shrinking, there is no tenter* object. The 'howmuch' curve just define* hoM 
much and in which direction the original object is moved. 



L 



Against || 



Targel 



Howmuch 



Original 



There are two possible ways of shrinking; cumulative and non cumulative. In cumulative shrink 
wrapping the deformation caused by the shrink wrapping is assigned back to tin- original *'t»|<*, I In 
non-cumulative shrink wrapping, the shape of Ihe original object isn'l affei lei I and remains tin same 

The tag ITRA is used to select Ihe type of shrink wrapping: 
50 - parallel 

54 - cylinder 

55 - sphere 
45 - normal 

If the tag isn't defined, parallel is used as a default 

The tag IFLC selects cumulative shrink wrapping: 

- non-cumulative (default) 

1 - cumulative 

These tags are attached to the shrink wrapping method objei I 
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ika.njsiokm Minion 



Transform method 

A Transform method can now be easily created from within the key editor Just set the Method' 
selector to Transform' and click the Create' button This creates a transform method with the 
necessary parameters: a coordsys and a b-spline curve. Then the envelope editor can be used to 
modify the default curve 

Note: the created transform method is inserted ahead of all the existing objects in the current hierarchy- 
level so the defined time transformation affects all objects in the current level. 

There are currently two envelopes available for this method: 

- Translate This shows the curve components in absolute space. 

- Time This shows how the time is mapped to a new time. The old time is represented by the V axis 
and the new time is represented by the V axis. 



New time 

A 



2 
I 




1 2... 



/ 



Old time 
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Example: 

I els imagine the situation where a sphere moves along a straight line. Required accelerations/ 
decelerations are created by a transform method. 
Open the key editor by selecting the lunction Animate/Edit. 

- Create a sphere and make it follow a palh by setting the method in the key ed.tor window to Path 
and click the Create button Select Polygonal' from the path dialog and draw a straight, two point 
line as the path. 

Create a transform method by setting the cycle gadgel in the key editor window to Translorm and 

then dick the create button. 

Open the envelope editor by clicking the Envelope button in the key editor window. 

- Set the Envelope selector to Time' and modify the X' curve. 
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Local Variables 



RPL now supports local variables (automatic variables). A variable is 'local' if it is defined inside I word 
definition. 

:test 

VARIABLE Imp I 
VARIABLE tmp2 

10 Imp! STORE 



A local variable is visible and defined only inside the word in question, 



Parameters 

Another new feature introduced by V3 is parameters'. Parameters arc listed <il the beginning 0) .1 word 
definition: 

For example, the following word; 

:TEST 

PARAM 

VARIABLE lAge 

VARIABLE aName 

FVARIABLE fMass 
ENDPARAM 



can be called as 

21 "Joanna' 65.5 TEST 



CIIAPTtR 4: KIM 



67 



MVV RIM WORDS 



New RPL words 

V3 contains a small but powerful set of words for manipulating windows, buttons and other display 

elements. In order lo use these words, the file rpl/sys/uixpl must be loaded first. 

Each word takes certain number of fixed parameters plus some optional tag-value pairs. A tag list 

must be terminated by ULDone. 

Also many other new RPL words have been included. 



ADD.Y1ENU 



SYNTAX aWord sName ADDMENU 

DESCRIPTION Adds a new menu item to the menu strip. When the menu is selected, the associated RPL word is 

called. 

If the name string contains the character r. a new sub item is created. Otherwise a new menu item is 

created. 
EXAMPLE This example creates a new menu item MyTools' consisting of two sub items: 'Fancy Tool' and Cool 

Tool'. 

: myFancyTool 

"Fancy Tool selected" PUTS 



: myCoolTool 

Cool Tool selected" PUTS 



COMPARE 



SYNTAX 
RETURNS 



& myFancyTool "MyTools/Fancy Tool" ADDMENU 
& myCoolTool "MyTools/Cool Tool" ADDMENU 



sFirst sSecond COMPARE iCmp 

The return value indicates the lexicographic relation of sFirst to sSecond, as follows: 

iCmp < sFirst is less than sSecond 

iCmp = sFirst is equal to sSecond 

iCmp > sFirst is greater than sSecond 

r\U "METERS sFirst. sSecond - strings to be compared 

RIPTION Compares two strings lexicographically and returns a value indicating their relationship. 
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CS.DEFINE 



5YNTAX vX vY vZ vOrigin CS_DEFINE 

PARAMETERS vX vY vZ - Three axes defining the orientation of the coordinate system 



vOrigin 



- Origin 



DESCRIPTION Defines the current coordinate system for CS.ROTATE, CS_SCALE CS_TRANSt ATE and 
CS.TRANSFABS words. 



EXAMPLE 


000 




1 00 




01 




00 1 




CS_DEFINE 


CS_ROTATE 



SYNTAX 



... aObj vDir fAngle CS_ROTATE 



DESCRIPTION Rotates objects about a given axis that passes through the coordinate origin. Rotation is applied In the 
current coordinate system 



OGET5EL 



EXAMPLE 
SEE ALSO 



1 90 CS.ROTATE 
CS.DEFINE 



CS.SCALt 



SYNTAX ... aObj vScale CS_SCALE 

DESCRIPTION Scales the given objects in the current coordinate system. 



EXAMPLE 



SEE ALSO 



O.CETSEL 

0.5 I 1 CS_SCALE 

CS_DEF1NE 



CS_TRANSFABS 



SYNTAX - aObj CS^TRANSFABS 

DESCRIPTION Modifies the given objects so that their object spaces will match the I urrenl i oordmate system. 
SEE ALSO CS DEFINE 
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CS TRANSLATE 



SYNTAX ... aObi vMove CS.TRANSLATE 

DESCRIPTION Moves the given objects. The transformation is applied to objecls in the current coordinate system. 

EXAMPLE 0.1 CS.TRANSLATE 

SEE ALSO CS_DEFINE 



DATETIME 



SYNTAX DATETIME iSoc iMin iHour iMday iMon iYear 

RETURNS Current date and time 

DESCRIPTION Returns the current date and time as follows: 
iSec - seconds after the minute (0-59) 

iMin - minutes after ihe hour (0-59) 

iHour hours since midnighl (0-23) 

iMday - day of month (1 -31 ) 
iMon - month (1-12, January = I) 

iYear - current year 



FCIOSE 



SYNTAX aFilc FCLOSE iSuccess 

RETURNS if FCLOSE succeeds 

PARAMETERS aFile - pointer to a file 

DESCRIPTION Closes the file opened by FOPEN. 



FEOF 



SYNTAX aFile FEOF iAtEof 

RETURNS nonzero if at end of File. otherwise 

PARAMETERS aFile pointer to a file 

I M st RIPTION Returns a nonzero value after the first read operation that attempts to read past the end of the file. It 
returns if the current position is not end-of-file. 



M.I IS 
SYN1W 
kl IIIRNS 



sString iMaxLen aFile FGETS iSuccess 
sString if FGETS succeeds. NULL otherwise 
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PARAMETERS sString buffer tor data to be read 

iMaxLen - maximim number ol characters to read 

aFile - pointer to a file 

DESCRIPTION FCETS reads a string from the file to the buffer. Characters are read from the < urrenl file position up to 
and including the first newline character, up to the end of the file, or until the number q\ i Ii.m.h tors 
read is equal to iMaxLen-l, whichever comes first. The result is stored in sString and I null i hara I i«l i . 
appended. The newline tharacter, if read, is included in the string. 



FOPEN 



SYNTAX sFilename sMode FOPEN aFile 

RETURNS Pointer to the opened file or NULL if failed 

PARAMETERS sFilename - Filename 

sMode - Access type 

DESCRIPTION Opens the file specified by filename. 

The sMode parameter specifies the type of access requested lor the file: 



<W" 



a 



w , 
•a I ■ 



Opens for reading only II Ihe file does not exist or cannot be found, the FOPEN word will 
return NULL 



Opens a file for writing. II Ihe given file exists, its contents are destroyed 

Opens for writing at the end of the file (appending); creates the hie Inst il it doesn i I <r*f 

Opens for both reading and writing. The file must exist. 

Opens a file for both reading and writing. If the given file exists, its 1 1 intents H 

Opens a file for reading and appending; ireates the file if il doesn I exfsl 

When the V+", "w-t", or "a+" access type is specified bolh reading and writing aw Allowed Uh-n 
switching between reading and writing there must be an intervening FSEEK operation Hi, following 
characters tan be included in sMode to specify the translation mode lor newline i Ii.ii.i. tw 



Open the file in text mode. In text mode, carriage-return-lineleed (CR 1 1 1 combinations « translated 
into single linefeeds (LFf on input and LF charailers are translated to CR 1 1 combinations on output 
Also.CTRL+Zis interpreted as an end-of file character on input In files opened foi n flding/writing 
FOPEN checks for a CTRL+Z at Ihe end ol the file and removes it it possible fhis i^ done because 
using the FSEEK and FTELL words to move within a file lhat ends wRh aCTRI / may cause FSEEK lo 
behave erratically near Ihe end ol Ihe file. 

b 

Open the file in binary mode The translations are not carried oul 
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I PUTS 



SYNTAX sString aFile FPUTS iSuccess 

RFTTURNS a non-negative value if FPUTS succeeds 

PARAMETERS sString - siring to be written 

aFile - pointer to a file 

DESCRIPTION Writes the string to Ihe file. 



FREAD 



SYNTAX sBuffer iSize iCount aFile FREAD iRead 

RETURNS number of items fully read 

PARAMETERS sBuffer - buffer for data to be read 

iSize - size of one item 

iCount number of items to be read 

aFile - pointer to a file 

DESCRIPTION Reads up to iCount items from aFile file to sBuffer. Fach item is of length iSize 



FSEFK 



SYNTAX 
RFTURNS 

PARAMETERS aFile 
iOffset 



aFile lOffset iOrigin FSEEK iSuCCGSS 
if FSEEK succeeds 

- pointer to a file 

- number of bytes from origin 
(Origin - initial position 

DESCRIPTION Repositions the pointer in a file. The iOrigin parameter can be any of the following: 
SI I K_CUR - current file position 
SEEK.END -end of file 
SFXK.SET - beginning of file 



Mill 



SYNTAX aFile FTF.LL (Position 

HI I URNS current file position 

i u; \MI 1 1 R5 .iFile - pointer to a file 

I Kin ION Returns the current file position. 
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FWRITE 



SYNTAX 

RETURNS 

PARAMETERS sBuffer 
iSize 



sBuffer iSize iCount aFile FWRITE iWritten 
number of items written 

- data to be written 

- size of one item 

iCount - number of items to be written 

aFile - pointer to a file 

DESCRIPTION Writes up to iCount items from sBuffer to aFile file. Each item is of length iSize. 



LEN 



SYNTAX sString LEN iLen 

RETURNS The length of the string 

PARAMETERS sString - string whose length is to be measured 

DESCRIPTION Returns the length of a string. 



NCPY 



SYNTAX 
PARAMETERS 



sDest sSource iCount NCPY 



sDesi 

sSource 
iCount 



- destination string 

- source string 

- maximum number of characters to copy 

DESCRIPTION Copies the first iCount characters of sSource to sDest. If iCount is less than ft equal to the length of 
sSource, a null character is not appended to the copied string. If iCount is greatei than the length ol 
sSource, the destination string is padded with null characters. 



NCAT 



SYNTAX 
PARAMETERS 



sDest sSource iCount NCAT 

sDest - destination string 

sSource - source string 

iCount - maximum number of characters to append 



DESCRIPTION Appends, at most, the first iCount characters of sSource to sDest The imti.il character of sSource 

overwrites Ihe terminating null character of sDest If a null < h.ir.u lei appears in sSource before iCount 
characters are appended, NCAT appends all iharaclers from sSource up to the terminating null 
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character. If iCount is greater than the length of sSource, the length of sSource is used in place of 
iCount. The resulting string is terminated with a null character. 



NOISE 



SYNTAX 
PARAMETERS 



vPos fMin fMax fPower iOctaves NOISE vResult 

vPos - A parameter value for the noise function 

fMin, fMax - Clipping interval 

fPower - Defines variation speed. MUST be greater than 0. 

iOctaves - Level of detail of the noise. Must be greater than 0. 



vResult 



- A noise vector 



RETURN* 

DESCRIPTION A multi-purpose three dimensional noise function, which computes continouously and randomly 
varying vector value from the parameter vector. The parameter vPos can be any point in space. The 
result vectors x f y and i coordinate component values are always inside the range [0,1]. 

The Octaves' parameter defines the level of detail Le. how many iterations of fractal noise is included 
in the result. 

The fMin, fMax and fPower parameters define an output value filter for the result. The initial coordinate 
values of the computed noise are clipped to the interval defined by fMin and fMax and then rescaled 
back to the 10,1 1 interval. In practise this means that the smaller the difference between fMin and fMax. 
the larger constant value areas are created. Finally, the noise result components are raised lo the 
power 'fPower'. The bigger the value, the more rapidly noise values change from one extreme lo the 
other. 

Good default values are for example: 

- Octaves = 3 

- fMin = 0, fMax = 1 (no clipping) or fMin = 03, fMax = 0.7 (some clipping) 

- fPower = 1 (Linear variation speed) or fPower = 4 (rapid variations) 



O MAKENAME 



SYNTAX aObj sName 0_MAKENAME 

DESCRIPTION Builds up a siring consisting of a full objed path name from the given object, 
i \ AMPLE ( print the name of the first selected objed 

400 STRING sName 



SI I M so 



O..CETSEL sName 0_MAKENAMf 
sName PUTS 

O.FIND 
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PRJ SETIIOOK 



TEMPLATE aHook PRJ_SETHOOK 

PARAMETERS aHook - address of the RPL hook word 

DESCRIPTION This words allows you to read and process input plane 3d coordinates directly 

The word sets a callback hook for all view windows. The hook procedure gets notification messa 
when the mouse is moved over any active view window or when a mouse button is pressed I H 
released over a view window. The user must remove the hook when no longer needed lb remot 
callback hook, call PRJ.SETHOOK with as the callback address, i.e. 
PRJ_SETHOOK 

EXAMPLE "ui.rpl" LOAD 

100 STRING sBuf 

: cbViewWindow 
PARAM 

FVARIABLE PosX 

FVARIABLE PosY 

FVARIABLE PosZ 

VARIABLE iEvent 
ENDPARAM 

UIWM_Move iEvent FETCH = IF 

PosX FFETCH PosV FFETCH PosZ FFETCH 
"View mouse pos %g %g %g" sBuf SPRINTr 
sBul PUTS 

ENDIF 

UIWM_LMBDown iEvent FETCH = IF 

"View mouse button clicked" sBuf CPY 

sBuf PUTS 
ENDIF 

UIWM_LMBUp iEvent FETCH = IF 

"View mouse button released" sBul CPY 
sBuf PUTS 
ENDIF 
i 

( set callback hook for view windows 
& cbViewWindow PRJ_SETHOOK 



REMOVE 



SYNTAX 



sFileName REMOVE (Success 
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RETURNS if REMOVE succeeds, -1 otherwise 

PARAMETERS sFileName - name of the file to be removed 
DESCRIPTION Deletes the file specified by sFileName 



SCANDIR 



SYNTAX 



sPaths sCallBack aData SCANDIR 



PARAMETERS sPaths 

sCallBack 
aData 



- paths to be scanned 

- name of the RPL word to be called for each file found 

- any user specified data to be forwarded to the RPL callback 

DESCRIPTION Scans the directories given in the sPaths parameter. For every file found the sCallBack RPL word is 

called. The directories in the sPaths parameter are separated by a semicolor (;). The callback function 
should leave a positive value on the stack to continue scanning. A value of or a negal.ve value 
terminates scanning The callback function has two parameters, full path name of the file and the user 
specified data. 

EXAMPLE VARIABLE count 

: MyCallBack 

DUP FETCH I + SWAP STORE I add I to count ) 
'File is " PUTS PUTS 10 13 EMIT EMIT 
I ( go on scanning ) 

» 

"macro,Tpr "MyCallBack" count SCANDIR 

count FETCH 



Ul WINDOW 



SYNTAX ... aCallBack iLeft Hop (Width iHeight sTitle UI.WINDOW aHnd 

RETURNS Handle to the opened window or NULL if failed 

FIXED PARAMETERS 

aCallBack - Callback word for the window to be created 

iLeft, iTop - Left top edge for the window 

iWidth, iHeight - Size of the window 

sTitle String for the window title bar 

rAGS None 

i 'i m Kit 1 ! ION Opens a window. Currently only the mouse events are reported to the callback. The callback takes the 
following parameters: 
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: cbWindovv 

PARAM 

VARIABLE iEvenl 
VARIABLE iMouscX 
VARIABLE iMouseY 

ENDPARAM 



Callbacks must not return any values. 

The iEvent parameter can be one of the following: 
UIWM_Move ( Mouse moved 

UIWM_LMBDown ( Left mouse button clicked 
UIWMJ_MBUp { Left mouse button released 

iMouseX and iMouseY reflect the current position of the mouse. 



Ul BUTTON 



SYNTAX 



... aWindow aCallback al.eft aTop aWidlh aHeight sText UI_BUTTON aHnd 



RETURNS Pointer to the created button or NULL 

FIXED PARAMETERS 

aWindow - Pointer to the window created by using UI.WINDOW 

aCallBack - Word which is called when the user clicks the button 

iLeft, iTop - Left-top edge of the button in a given window 

iWidth, iHeight - Size of the button. 

sText Text for I he button. 

TAGS ULDisabled - 1 = disabled, = enabled 

DESCRIPTION Creates a button in the g.ven window. When the user clicks the button, the word pointed U ..i allBai k 
is called. The callback doesn't take any parameters 

: c Button 

"Button Clicked" PUTS 



Ul CHECKBOX 



SYNTAX 
RETURNS 



... aWindow aCallBack il.eft iTop iWidth iHeight sText ULCHEC KBOX aHnd 
Handle to the created checkbox 
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FIXED PARAMETERS 

See ULBUTTON 

TAGS ULDisabled - I = disabled, = enabled 

UICB__Checked - I or depending on the desired slate of the check box. 

DESCRIPTION Creates a checkbox- The default slate is 'not checked . 

The callback is called with one parameter which defines whether or not the checkbox was set or reset: 

cbChecBox 

IF 

"Checked" PUTS 
ELSE 

"Not checked" PUTS 
ENDIF 



Ul STRING 



^YNTAX ... aWindow aCallback iLeft iTop iWidth IHeight sText ULSTRING aHnd 

RETURNS Address of the created string gadget or NU LL if failed 

FIXED PARAMETERS 

See ULBUTTON 

TAGS ULDisabled - I = disabled. = enabled 

UIST_Slring - String for the edit control 

DESCRIPTION Creates a string gadget (edit control). When the callback word ls called depends on the platform In 

Amiga the callback occurs when the user pressed either Enter or Tab in the string gadget In W.ndows, 
the callback occurs when the user leaves the edit control (either by using the Tab key or by act.vat.ng 
another control by using the mouse). 

; cbString 

"The user entered the string: %s" PUTS 



Ul.TEXT 



SYNTAX - aWindow aCallBack iLefl iTop iWidth .Height sText Ul.TEXT aHnd 

kl HIKNS Pointer to the created gadget 

HMD PARAMETERS 

See Ul BUTTON 






UlTXJfext Text to be displayed 

UITX_Border II 1. the text will be surrounded by a frame 
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DESCRIPTION Creates a 'read-only' text gadget 



NOTE 



Because this creates a 'read-only' gadget, the parameter 'aCallback' is unused and can be NUM.. Also 
the general purpose tag ULDisabled has no effect. 



Ul SLIDER 



SYNTAX ... aWindow aCallBack iLefl iTop iVVidlh .Height sText ULSLIDER aHnd 

RETURNS Pointer to the created slider 

FIXED PARAMETERS 

See ULBUTTON 

TAGS ULDisabled - 1 = Disabled on enabled 

UISL_Min - Minimun value 

UlSL.Max - Maximum value 
UlSL.Level Current value 

DESCRIPTION Creates a slider. When the user plays with the slider, the callback is called wilh one paramete reft i i 

the current level ol the slider. 

; cbSlider 

"Current leveMfcd* PUTS 



Ul MX 



SYNTAX ... aWindow aCallback iLeft iTop iWidth .Height sText UI_MX aHnd 

RETURNS Address of the created gadget 

FIXED PARAMETERS 

See ULBUTTON 

TAGS UIMX_Active - Currently active item 

UIMX.Labels Pointer array of strings terminated with null. For more information about hi iw i 
create string pointer arrays using RPL, see rpl/ui.rpl. 

DESCRIPTION Creates a 'Mutual Exclusive' gadget. The gadget consists ol two ^r more i hi - and Iht US. I I on 

selecl only one item at a time. In Amiga. Ihe Cycle gadgel is used, rhe Windows version uses Combo 
Box'. 

The callback is called with one parameter which defines the ordinal number ol the SCfo ted object. 
: cbMx 

"You selected the item %d" PUTS 
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III. DELET E 

SYNTAX 
RETURNS 



aHnd LII.DELETE 
None 



FIXED PARAMETERS 
aHnd 



- Address of the window to be deleted (closed) 



TAGS None 

DESCRIPTION Deletes the given window. All the gadgets created on the window will automatically be deleted as well. 



Ul SETATTRS 



SYNTAX 
RETURNS 



.... aHnd UI_SETATTRS 

None 



FIXED PARAMETERS 

aHnd - Handle to the gadget to be manipulated 

TAGS Possible tags depend on the lype of (he gadget. 

DESCRIPTION This word is used for setting window and gadget attributes, The parameter list consist of a number of 
tag-value pairs defining attributes and new values for them. 

For example, to change the current level of the slider to 10: 

ULDone 

20 UlSLJ-evel 

aMySlider FETCH ULSETATTRS 



Ul GETATTRS 



SYNTAX 
RETURNS 



... aHnd ULGETATTRS 

None 



FIXED PARAMETERS 
aHnd 



TAGS 



- Handle to the gadget to be read 
Tags depend on the gadget in question 



Dl SCRIPTION This word can be used for reading attributes lrom the display elements. For example, lo read the 
current value of the slider: 

VARIABLE aStrPtr 

ULDone 

aStrPtr UlST.String 

ULGETATTRS 



aStrPtr FETCH 'The user typed: %s" PUTS 






CHANGES TO RPI SPECIFICATION 



Ul_ REALIZE 



SYNTAX aHnd UI.REALIZE 

RETURNS None 



FIXED PARAMETERS 
aHnd 



- Handle to a window to be realized 



TAGS 



None 



DESCRIPTION Displays all the created gadgets in Ihe given window. The following example shows foe basil ftrui Jure 
of all GUI oriented programs: 

( create a window 

ULDone ... ULWINDOW aWnd STORE 

( create number of gadgets 

ULDone ... aWnd FETCH ULBUTTON aBuUon STORE 

ULDone... aWnd FETCH U! .... 



( Now the window is complete and must be realized 
aWnd FETCH ULREALIZE 

A window needs to be realized only once. 



I&l 



SPRINTF 



Changes to RPL specification 



I&| word no longer exists. The word & can now be used everywhere when- address ol .1 word needs l«* 
be fetched. 



RPI. word SPRINTF takes the parameters in a more natural order, e.g. 

40 STRING temp 

1 2 3 "one %cl two %d. three %d" temp SPRINTF 

temp PUTS 

now prints 

one 1, two 2, three 3 
nol 

one 3, two 2. three 1 

as before 
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CHANCES 10 RPL SPfCII ICVHON 



PUTS 



RPL word PUTS can now have a formal string, e. 

"Hi there!" PUTS 
prints 



and 



prints 



Hi there! 



2 3 + "high %d" PUTS 



high 5 



A COMPLETE GUI PROGRAMMING EXAMPLE 

f GUI EXAMPLE 

"ui.rpl" LOAD ( This contains definitions required by gui words 

( Define a new data type 'pointer array. The PARRAY takes one parameter which 
( defines the number of items in the array to be created. 
( MX gadget requires string labels in this format. For example: 10 PARRAY 
( creates array of ten items. 

: PARRAY 

<BUILDS 4 " ALLOT DOES> 



( This stores a 32 bit address to a given slot of the array. For example 
{ 555 2 PSTORE stores the value 555 to the third slot. 

: PSTORE 

4 ' + STORF 

- 

I Global variables for holding addresses of gadgets to be created 

VARIABLE aWindow 
VARIABLE aButton 
VARIABLE aCheckBox 
VARIABLE aSlider 
VARIABLE aMx 
VARIABLE aString 
VARIABLF aT©d 



B2 



CHAPTER 4IRPL 



\ COMPI I II GUI PROGRAMMING | YAM PI I 



VARIABLE aText2 
VARIABLE aText3 
100 STRING sBuf 

( A general usage word which prints out a given string using aText2 gadget 

: PrinlMsg 

ULDone SWAP UlTX.Texl aTexl2 FETCH UI.SETATTRS 

{ Callbacks for gadgets 

: cbButlon 
( local variables 
VARIABLE aTmp 
100 STRING sTmp 

( fetch a string from the string gadget 

ULDone aTmp UIST_String aString FETCH ULGETATTRS 

( and print it out 

aTmp FETCH "Loading %$* sTmp SPRINTF 

sTmp PrintMsg 



; cbCheck 



IF 



ULDone 1 


ULDisablcd 


aSlider 


FETCH 


Ul SETATTRS 


ULDone 1 


ULDisabled 


aMx 


FETCH 


Ul SETATTRS 


ULDone 1 


ULDisabled 


aString 


FETCH 


Ul SETATTRS 


ULDone 1 


ULDisabled 


aButton 


FETCH 


Ul SETATTRS 


ELSE 










ULDone 


ULDisabled 


aSlider 


FETCH 


Ul SETATTRS 


ULDone 


ULDisabled 


aMx 


FETCH 


Ul SETATTRS 


ULDone 


ULDisabled 


aString 


FETCH 


Ul SETAI rRs 


ULDone 


ULDisabled 


aButton 


FETCH 


Ul SUM IKs 


ENDIF 










■ cbSlider 










"Slider °/od"sBuf SPRINTF 








sBuf PrintMsg 
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A CO MI'll II CUI PROGRAMMING EXAMPLE 



: cbMx 

Mutual Exclude W sBuf SPRINTF 
sBuf PrintMsg 

: cbString 
PrintMsg 

( Callback for window 

cbWindow 
PARAM ( parameters ) 

VARIABLE iEvenl 

VARIABLE iMouseX 

VARIABLE iMouseY 
ENDPARAM 
UIWM_Move (Event FETCH = IF 

iMouseY FETCH iMouseX FETCH "Mouse moved to %ld %ld" sBul SPRINTF 

ULDone sBuf UlTXJext aTextS FETCH ULSETATTRS 
ENDIF 

UIWM.LMBDown iEvenl FETCH = IF 

"Mouse button clicked" sBuf CPY 

ULDone sBuf UlTXJfext aText3 FETCH ULSETATTRS 
ENDIF 

UIWM_LMBUp iEvent FETCH = IF 

"Mouse button released" sBuf CPY 

ULDone sBuf UlTXJext aText3 FETCH ULSETATTRS 
ENDIF 



{ create a window 

ULDone 

& cbWindow 400 200 "RPL Example Window* Ul_ WINDOW aWindow STORE 

( create a read-only text 

ULDone 

"RPL gadgets" UlTXJext 

aWindow FETCH 150 15 100 12 "Header Text:" UIJ'EXT aTexl STORE 

( create a check box 

ULDone 

UlCBJThecked 

aWindow FETCH & cbCheck 100 30 50 12 "Check Box" ULCHECKBOX aCheckBox STORE 
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( create a siring gadget 

ULDone 

"spline" UIST_Stnng 

aWindow FETCH & cbString 100 45 150 12 "String" ULSTRING aStrfng STORE 

( create a slider gadget 

ULDone 

UISL_Min 

100 UlSL.Max 

20 UISLJ_evel 

aWindow FETCH & cbSlider 100 60 50 12 "Slider" ULSLIDER aSlider STORE 

( create a mulual exclude gadget 

5 PARRAY aLabels 



"Choice 
"Choice 
"Choice 
"Choice 


ULDone 

2 

aLabels 



V aLabels 
T aLabels 

Y aLabels 
4" aLabels 

aLabels 

UIMX_Active 
LIIMX Labels 



PSTORE 

1 PSTORE 

2 PSTORE 

3 PSTORE 

4 PSTORE 



aWindow FETCH & cbMx 100 75 150 12 *Mx" UI.MX aMx STORE 
( create a button gadgel 

ULDone 

aWindow FETCH & cbBulton 100 90 150 12 "Button" ULBUTTON aButton STORE 

( This text gadget shows gadget events 

ULDone 

"Welcome to RPI" UlTXJext 

1 UlTX.Bordcr 

aWindow FETCH 100 105 150 12 "Gadget:" U1JTEXT aTexl2 STORE 
( window events are printed here 

ULDone 

"This is cool* UlTXJext 

1 UlTX.Border 

aWindow FETCH 100 130 250 12 "Info;" Ul.TEXT aText3 STORE 

( realize gadgets 

aWindow FFTCH ULREALIZE 

(END OF RPL EXAMPLE ) 
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5. Miscellaneous 



Compatibility 

The binary format or many data types of Real 3D has been changed, but the program can COflWfl 
modified data ilems automatically Version 3 can read all v2.x files Version 2\ can not ah* 
v.3.x files. 

The major changes are: 

- MORPHING_CL05ED method does not exist any more. 

- The morphing method specific tags have been changed. Two new tags can now be asscx toted Wfth 
the morphing method: 

- IFLC (open/closed, selects also data to be morphedl 

- IMIT (Morphing Interpolation Type) 

- Curves can now contain a knot sequence 

- Fidelity added to bone description for C_SKf LETON word. 

- Freeform objects may contain skeleton fitting arrays. 

The menu modifications mean that old RPL startup files are not fully compatible II sou haw 
customized the RPL startup, take the modifications from the old fife and add Ihcm to khc Ml applied 
with the new version. After that, verify that MENU word parameters m.it, h the new menu S) Stem 

The rendering engine algorithms have been modified, mainly for speed optimfeaUon reasons this 
affects the image output. Therefore, do not render consecutive animation Frames using dlfferenl 
program versions, because even liny changes may spoil the animation 
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COMPARISON OF AMIGA' WINDOWS SPECIFIC FEATURES 



Comparison of Amiga / Windows specific 
features 

This appendix and the actual Real 3D v2A manual describe the version for Windows 3.1 and Windows 
NT platforms. The version for Amiga has almost identical functions. Nevertheless, there are some 
operating system specific features and differences, which are described in this chapter. See also the 
readme file of the Amiga version and the AmigaGuide help files for more information. 

Installation 

To install the Amiga version to hard disk, insert the disk 'Real3D_V3_Disk1' to a floppy drive, double- 
click the Install' icon and follow the instructions. The full installation requires about 8 megabytes of 
hard disk space 

The installation procedure uses the standard Installer, (cj Copyright 1991-93 Commodore-Amiga, Inc 
All Rights Reserved. Reproduced and distributed under license from Commodore. 

Naming conventions 

The File menu of the Windows version is called Project menu in Amiga. 

The dialog word is frequently used in the Windows environment instead of the word requester' which 

is more familiar to Amiga users 

Amiga's gadgets arc often called as buttons, list boxes, edit boxes etc. in the Windows version. 

Menu function differences 

Project/Project/lnserl Sections, Save Sections, Replace Sections 

Amiga projects may contain multiple screens. Therefore, the sections requester contains an additional 
checkbox to control screen data 10 operations. 

Project/Materials/ Window 

In the Amiga version, some of the material window features can be accessed through menus, whereas 

I he Windows version uses gadgets. 

File/Materials/Matcrial Select Window 

The material select window which which allows material selection from preview images is not 

available in Amiga 
Pi ojei I Windows/ View superbilmap 
Pi i ijn I Windows/View borderless 

ProjC* t Windows/View dbuffered 

These are Amiga specific view window window types. 
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View_Su perbitmap: 

Open superbitmap View. This means Ihe window can be moved over a much larger virtual' View using 
the scroll-bars at the bottom and right side. Objects can be created and modified, even rendered on 
any part of the superbitmap. 

View_Borderless: 

Open View covering the full screen. This has no visible borders and obscures the menu ship I Ins 
window type is usually needed for rendering final images or animations where window bonders air 
not desirable. 

View.DBuffered: 

Opens a double-buffered borderless View on a new screen. This enables wire frame mod, mi to be 
observed without seeing the intermediate drawing steps, so the image does not flicker I hi new $1 reen 
is always 4 color, 640 wide, maximum height and interlaced. This screen is a special private si men and 
no other windows can be opened on iL By default the View projection type is perspe. ft 1 

Projccl/Windows/Animation 

The automatic preview feature of the Windows version is not available. 

In the windows version, you can select a view window to be saved using Ihe Save combo box In Ihe 
Amiga version, you can specify a screen to be saved with the following gadgets: 

Screens & Saved 

The list selector enables the one of Ihe open Real 3D screens to be selected for saving to .111 II I hi. 
after each animation frame. The name can also be typed directly into the Saved texl gadget II .111 
external screen has been opened, then it can be selected and will be saved using the Hie settings 
selected with Project/ExternaLScreen/Settings. 

Save 

If set, then the selected screen is saved to a file and Frame is incremented, alter rendering ol the 1 urrenl 
frame is completed. 

Screen File 

The name and path for the screen image files saved by the animation system 

In the Amiga version, it is possible to open the animation window to a separate screen l hi-, is 
controlled by Settings/Ceneral/Anim. screen option. 

Project/Windows/Palette 

Opens a palette window. This is opened on its own private HAM screen. The Palette is used to 1 ontrol 
the R,G,B values of the current color and the 16 register color values. Th< i urrenl color Is used 
whenever Real 3D requires a color value for a function eg. Modify/Properties I oloi 

The register colors give the user fast access to 16 different color definitions Selei ling one of the 
register color buttons makes the current color Ihe same as ihe current value ol the register color. The 
value of the register color is then changed using either Ihe sliders or Sfilei ting from the color 
spectrum with the left mouse button, Holding the left button down while moving over the color 
spectrum changes the current color and the slider values continuously rhere is no need to confirm 
Ihese changes. The effects take place when the 'OK' gadget is pressed It is also necessary to select the 
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settings required BEFORE using a function which uses the current color. If a Palette window is not 
currently open, then the last setting for the current color will be used 

Project" Windows; Screen 

In the Amiga version, it is possible to use several screens at the same time. The screen window can be 

used to manage screens. 

This opens a small window which enables control of Ihe public screens used by Real 3D. It is opened 
automatically when a new screen is created to provide a 'handle' to the Real 3D menus, until other 
windows have been opened. 

Gadgets of the screen window: 

Default 

Make active screen the default public screen. 

Jump 

Jump to next public screen. The control window will follow. 

Close 

Closes all Real 3D windows on the current screen then attempts to close the screen. If other windows 
prevent the closure, then a warning requester will be opened 

Hijack 

When enabled, windows and requesters opened For public screens will be hijacked and opened on the 
default public screen. This allows other applications which use public screens to be integrated into Ihe 
Real 3D system One possibility lor this is to integrate a text editor for creating and editing the text for 
RPL 

Pop-to- front 

When windows and requesters are opened on the default public screen, it will be brought lo the front. 

ProjecL/Windows/Color Wheel 

The standard color wheel window is also available in systems using Operating System v.39 or later, 
You can use it instead of the HAM palette window. 

Project/F.nvironment/Open screen 

Open a new Real 3D screen using screen settings requester. 

Project/Environment/Make Del Pub. 

Make currently selected screen Ihe default public screen. 

I'roject/Environment/Close screen 

Closes Ihe selected Real 3D screen. 

Project Lnvironmenl/Close current 

Closes any windows currently open on active » Ceen and then attempts lo close the screen. If other 
programs have opened windows on Ihe Real 3D screen, then the screen cannot be closed and the user 
will be warned. 



90 



CHAPTFR 5- MISCELLANEOUS 



COMPARISON OF AMICV WINDOWS SPECIFIC FEATURI S 



Project/Environment/Screen Palette 

Opens a requester enabling the active screen colors to be changed. The screen register color to 
modify is selected from the color spectrum, then it can be adjusted using the RGB sliders Two pre- 
defined palette definitions can be loaded by selecting either of the two button-gadgets. The COLOR 
SCALE' definition is used with Render Settings/Color Shading'. Screen palettes are saved .is pari ol 
the screens data section. 

The screen palette requester contains two numerical gadgets. The purpose of the gadgets is to spe ify 
a range of palette entries to be used in greyscale shading. This way, the palette can be divided inti 1 twi - 
groups of colors; user interface colors and greyscale shading colors. The user interface colors 1 an be 
freely modified without interfering the screen output quality. 

The color range defined by the two gadgets is used when the GREYSCALE button is hit Instead of 
spreading the greyscale gradient over the whole palette, only the colors within Ihe range are rrh riffled 
Also the greyscale rendering algorithms use colors in the range. 

For example, you may set the 'Greyscale from' value to 4 and the 'To' value to 15 tor a T bil plane 1 16 
colors) screen. A press of Ihe GREYSCALE button spreads Ihe greyscale over the new range \ii.m Hul 
the first four colors can be modified to obtain a suitable user interface color combination 

Mote: this feature is available only on screens opened by Real 3D. Note also that coli ir* ale ihadi 
ignores the range definition, using all colors in the palette 

Environment/External screen 

These functions enable a library for controlling an External screen, like a frame buffel , to I ■■ ■ • ■ I Ito 
sub menu items are: 

Open 

Open an external screen with its specified external screen library. 

Close 

Close external screen and its library 

Set_Modes 

This function allows settings of an external screen to be modified Nol all libraries need (his film lion, 
and so will nol produce a requester. 

Settings 

Opens external screen requesterallowingtheusertoseleclexlern.il screen library and file format 

Gadgets of the External screen requester: 

Library Name of External screen library. 

IFF24 IFF 24 file format used. 

TARGA Targa file format used. 

TARGA+A Targa tile format with alpha information used for saving 

CUSTOM External screen's own formal 

Save 

Save image from external screen using format specified by settings 
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Create/Build Frceform/Font curve extractor 

The TrueType font extractor is not available in Ihe Amiga version. 

Modify/Properties/Color 

The color of the selected objects becomes the RGB values of the current color. If the Shift key is held 
down when this function is activated, the modal color requester is opened and Ihe color of the first 
selected object is shown. 



Modify/Color 



This menu and it submenues are available in the Windows version only. In Ihe Amiga version, use 
Modify/Properties/Color to change the color of the selected objects. 



View/Grid/Define 

The grid requester of the Amiga version allows the user to define a 16 bit Pattern' value, which defines 
a bit mask for grid lines. This makes it possible to use dotted lines, eU 

View/Save Window 

Not available in the Amiga version. Only complete screens can be saved using Project/Environment/ 

Save screen function. 

Settings/View Window color 

This menu does not exist in the Amiga version. Use the Project/Environment/ Screen palette function 
to set the background color (the first palette entry) to a desired value. 



Tool/Icons 



The Auto size option of the Windows version is not available. 
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Index 



Symbols 

l&l 91 
3DStudio files 

exporting to 3DS 47 

loading 33 



Additive option (glow) 50 

ADDMENU 68 

Alpha channel output in IFF file rendering 49 

Angle 

constraint of skeleton joint 40 

of helix 40 

of rotation 37 
Angle scope handler 17, 34 
Animate/ 52 
Animation 18-32 

creating an animation, example 7 

rendering 10 

restoring after playback 32 
Animation system 55-66 
Animation window (Amiga/Windows) 89 
Anti-aliasing 34. 50. Set* also Super sampling 
Attributes 

geometric 44 

Modify/attributes dialog 43 

Settings/Attributes 54 

skeleton attributes 40 
Auto Box Rendering 48 
Auto Track 55 

B 

Backdrop image blitting 51 
Bit Backdrop 51 
Blurring sensitivity 51 
Borderless view 89 
Bounding Box 43 
Brightness 

of glow 34, 50 



Bumps 

density and height 34 



Camera View 48 
Canceling 

creation/modification operation 37 
Center (view tool window) 37 

Clockwise normals option (freeform type dialog] 46 

Closed morphing 60 

COG 60. See also Pivot {key editor) 

Col.repl 35 

Color 

dither color handler 35 

material color 35 

Modify/Color (Windows version) 92 

Modify/Properties/Color (Amiga version] 92 

morphing 61 

window color 92 
COMPARE 68 

Comparison of Amiga / Windows spenli. features 88 

Compatibility 87 

Controls/ 40 42 

Convert to Triset 47 

Create (key editor} 56 

Create Key (key editor) 56 

Create/ 38-43 

Creating 

a primitive 36 
CS.DEFINE 69 
CS.ROTATE 69 
CS.SCAEE 69 
CS.TRANSFABS 69 
CSJTRANSLATE 70 
Cumulative m brink wrapping 65 

D 

DATETIME 70 
DBuffered view 89 
Delete Key (key editor) H 
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Depth 

of a primitive 37 
Depth scope handler 34 
di' Rpl variable 35 
Discrete interpolation 60 
Distance anti-aliasing 50 
Distance blur 51 
Distribute (key editor) 56 
Dither color handler 35 
Drawing Settings 51 
DXF formal 

exporting in 51 



Edge X/Y 33 
Edit (key editor) 57 
Editing animation 53 
Envelope window 21 
Envelopes 57 

key editor 56 
Export DXF 51 

External screen (Amiga version 
Extras/ 53-54 



Fade 46 

animating 23 
FCLOSE 70 
FEOF 70 
FCETS 70 
Fidelity 41, 47 

an example 26 
File/ 33-38 
Fixed 

skeleton type 42 

I ixed size option (glow) 50 

FOPEN 71 

I I'll IS 72 

i. ictaKs 15 

Fractals 43 

ll.lMI 

IKI \l> 72 

-.k' |i ton type -ID 
Iri'i-I 

into groups 53 
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Freeform modelling 
example 12-15 

Freeform/ 51 

Freq X and Y 35 

Friction 

of skeleton joint 41 

FSEEK 72 

FSKF tag 41 

FTELL 72 

FWRITE 73 



General settings 54 
Geometry 

geometry dialog 44 

morphing 61 
Glow 34. 50 

an example 16 
Gradient See Edge X/Y 
Gravity (surface method) 64 
Grid requester (Amiga) 92 
Group 38 

deselecting 53 

H 

Helix 40 

Hierarchical skeleton 42, 63 

an example 27 
Hierarhical animations 

an example 20 

I 

IFAD tag 23. 46, 62 

IFF lile rendering 49 

IFLG tag 59, 60, 65 

IINDlag 63 

IINH tag 39 

Image formats 36 

IM FT tag 59, 60 

Inherit option 19, 39 

Installation (Amiga/Windows) 88 

Interlace fields 48 

Interpolation 56, 60. See also IFLG tag; IMF! tag 

Inverse kinematics 52, 63 

Invisible checkbox (key editor) 55 



ISKE tag 64 
ITRAtag 65 



JPEG images 36 
JPEG support 49 



Key editor 18, 55 
Keyframe animations 52, 59 

an example 9, 20 
Knot sequence 55. See also Distribute (key editor); Path 
animations 



Landscape 43 

LEN 73 

Linear/B-Splinc/Discrete (key editor) 56 

Link 38 

I inks (surface method) 64 

Loading 

landscapes/ trees 43 

render settings 49 

M 

Mapping 35 

defining 8 
Material 16-18 

color 35 

defining 8 

morphing 61 
Materials/Purge 36 
Materials/Window 33-36 
Menu function differences (Amiga/Windows) 88 
Menu functions 33-54 
Method 

Create/Method menu 39 

key editor 56 
Modelling 10- 16 

freeform. an example 12 
Modify/ 43-47 
Modifying 

a primitive 36 
Morphing 60 

an example 23 

skeletons, an example 29 
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Naming conventions (Amiga/Windows) 88 

NCAT 73 

NCPY 75 

Next (key editor) 56 

"No RPL busy requester" checkbox 54 

NOISE 74 

Non-cumulative shrink wrapping 65 

o 

O.GETSEL 69 
O.MAKtNAME 74 
Objects/Load 33 
Outl. Depth 37 



Palette window (Amiga version) 89 
Parallel Shrinking 13 
Path animations 59 

an example 18 
Periodic (key editor) 56 
Pivot (key editor) 57 
Pivol point 60 

an example 22 
Position coordinates 37 
Post effects 17, 49 
PPM images 36 
Prev (key editor) 56 

Prtijecl/lnsert Sections. Save Set lions Kepl.it i' V 
Properties/ 43-46 
PUTS 82 
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Reflect 46 

Relative texture coordinates 35 

REMOVE 75 

Render/Settings 48-51 

Rendering 

animation 10 

Auto Box 48 

IFF file 49 

quality 34. See also Super sampling 

lime. See Mo Box Rendering; Super sampling 
Repeat Last 54 
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'ro' RPL variable 34 
Rotate (envelope editor) 58 
Roughness bump handler 34 
Round 47 
example 10 



Sampling density 48 
Saving 

landscapes/ trees 43 
render settings 49 
Scale lenvelope editor) 58 
SCANDIR 76 
Scope handler 34 
Screen Palette 91 
Screen window (Amiga version! 
Settings/ 54 

Shear (envelope editor) 58 
Show selected objects 54 
Shrink wrapping 53, 64 

an example 32 
SIDE lag 38, 63 
Simple skeleton method 63 
Skeleton 40-43, 52 
an example 24 
method 63 

morphing, an example 29 
SMATtags 36 
Special/ Reflect 46 
SPRINTF 81 
STOP (key editor) 56 
Structure, 38-39 
Sub skeletons 42 
Super sampling 48 
Superbitmap view 89 
Surface coordinates 11 
SuiLki' method 64 

.in example 30 
mitI.iu' to Groups 47 



90 



fags 

rptilng 62 



Texture 

antialiasing 34 

frequency 33 

gradient 33 

one-sided 34 
Time 

inheritance 39 
Transform method 66 
Translate (envelope editor) 58 
Tree 15, 43 
Trisel 

converting objects to trisels 47 

shading 33 
Type 

offreeform 46 
Type/Surface 47 

u 

ULBUTTON 77 
ULCHECKBOX 77 
ULDELETE 80 
ULCETATTRS 80 
UI_MX 79 
ULREALIZE 81 
ULSETATTRS 80 
ULSIJDER 79 
Ul STRING 78 
U I .TEXT 78 
Ul WINDOW 76 



Vectors 53 
View/ 47 51 
ViewTool window 36 
VMOVlag 59 
VROTtflg 59 
VSIIE tag 59 

w 

Window color 92 
Windows/ViewTool 36-38 
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REAL 3D V.3 Some highlights 

Interface 

- Several functions have been introduced to allow users easier access to commonly used functions. 

- The view tool window provides quick access to object creation and modification tools. 

- Object geometry can now be editited directly at any time. Points, depth, etc. can now be edited numerically 
through This new window, 

Fast rendering 

- The rendering engine has been improved and a new 'auto box' rendering mode introduced. On complex 
scenes this can reduce render time by half. 

Pick at surface |F 

- This is a new type of view mode, user can now draw curves on the surface of other objects. Using the new 
mode objects can be joined together with spline patches seamlessly or shapes extruded from a surface. 
Background Blittmg 

- All view windows can have a full colour backdrop image in wireframe mode for rotoscoping, perspective 
matching, etc. 

Post Processing Effects 

- A new open interface for postprocessing has been included. Effects such as lens flares, glows, etc, can now 
be added to any scene. One of tne included effects, Material Glow, allows the user to create all types of 
effects such as fire, laser beams, etc. 

Animation 

- The animation system has been extended, new methods include keyframincj, drag, and shrink wrapping. 

- The drag method allows easy creation of animation where objects need to walk 
accross a surface. The user defines impact points on the object and REAL will 'walk' 
the objects across a given surface by those points. ^T 

• Animated shrink wrapping provides access to effects such as footprints in the snow. 
Any animated object can be moved across a mesh leaving an impression as it goes. 

- Skeletons can now be nested allowing them to be branched. Constraints have been 
introduced so each join of a skeleton can be fully controlled by the user. 

- Object fades. A new attribute 'fade' has been introduced allowing objects to have 
a transparency level which is independent to any materials. The fade level can be 
morphed allowing all kinds of effects to be created simply and quickly. RFAI cnPT 




